发起提现

POST

/api/v1/wallet/withdrawal/apply

从租户余额提币到指定地址。

手续费模式: 外扣 — amount 为实际到账金额，手续费在此基础上额外扣除。

租户余额扣除 = amount + 手续费

各链手续费:

链	USDT	USDC
BNB	0.05	0.05
ETH	0.50	0.50
ARBITRUM	0.05	0.05
TRON	1.00	—
SOLANA	0.05	0.05

举例: 提现 100 USDT (BNB 链)，手续费 0.05，到账 100 USDT，租户余额扣除 100.05 USDT。

审批机制: 金额 ≤ auto_approve_threshold 时自动审批，否则需管理员手动审批。

Request

Header Params

Body Params application/jsonRequired

Examples

BNB 链提现 1.37 USDTTRON 链提现 2.45 USDTSolana 链提现 2.89 USDC

{
    "externalUserId": "user_001",
    "externalOrderId": "TENANT-WD-20260506-0001",
    "toAddress": "0x3a064c586059a86925bf3f49bc535d984906e239",
    "amount": "1.37",
    "currency": "USDT",
    "network": "BNB"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

BNB 链提现 1.37 USDTTRON 链提现 2.45 USDTSolana 链提现 2.89 USDC

curl --location '/api/v1/wallet/withdrawal/apply' \
--header 'tenant-id: 1' \
--header 'Content-Type: application/json' \
--data '{
    "externalUserId": "user_001",
    "externalOrderId": "TENANT-WD-20260506-0001",
    "toAddress": "0x3a064c586059a86925bf3f49bc535d984906e239",
    "amount": "1.37",
    "currency": "USDT",
    "network": "BNB"
}'

Responses

🟢200OK

application/json

提现申请成功

Bodyapplication/json

Example

{
    "code": 0,
    "msg": "success",
    "data": {
        "orderId": "WD-ADB108F2372040068D27D9CE44BC2C35",
        "externalOrderId": "TENANT-WD-20260506-0001",
        "network": "BNB",
        "currency": "USDT",
        "toAddress": "0x3a064c586059a86925bf3f49bc535d984906e239",
        "amount": 1.37,
        "fee": 0.05,
        "status": "PENDING",
        "txHash": null,
        "remark": null,
        "createTime": "2026-04-01T12:00:00",
        "updateTime": "2026-04-01T12:00:00"
    },
    "ok": true
}

Modified at 2026-05-07 09:40:42

查询用户充值地址

查询提现记录