用户业务系统间划转
类型: POST
接口描述: /v4/balance/transfer
请求参数
| 名称 | 类型 | 是否必填 | 默认值 | 描述 | 取值范围 |
|---|---|---|---|---|---|
| bizId | string | 是 | N/A | 用于幂等处理的唯一ID | 最大长度:128 |
| from | enum | 是 | N/A | 资金转出账户 | bizType 枚举 |
| to | enum | 是 | N/A | 资金转入账户 | bizType 枚举 |
| currency | string | 是 | N/A | 币种名称,必须小写(例如 usdt、btc) | |
| symbol | string | 否 | N/A | 划转交易对(必须小写)。如果转入或转出账户中有一个是杠杆账户,则必填 | |
| amount | bigDecimal | 是 | N/A | 划转金额 |
注意事项
此接口用于同一用户下不同业务系统之间的资金划转。
bizId确保幂等处理,建议保存用于对账。- 如涉及杠杆账户,必须提供
symbol参数。
请求示例
curl --location --request POST 'https://sapi.xt.com/v4/balance/transfer' \
--header 'accept: */*' \
--header 'Content-Type: application/json' \
--header 'validate-algorithms: HmacSHA256' \
--header 'validate-recvwindow: 60000' \
--header 'validate-appkey: xxxxxxxxxx' \
--header 'validate-timestamp: xxxxxxxxxx' \
--header 'validate-signature: xxxxxxxxxx' \
--data '{
"bizId": "xxxx_xxxxxxxx",
"from": "SPOT",
"to": "FUTURES_U",
"currency": "USDT",
"amount": "1"
}'
响应示例
响应
{
"rc": 0,
"mc": "SUCCESS",
"ma": [],
"result": 123456 // 返回的划转唯一ID,建议保存用于对账
}