跳到主要内容

用户业务系统间划转

类型: POST

接口描述: /v4/balance/transfer

请求参数

名称类型是否必填默认值描述取值范围
bizIdstringN/A用于幂等处理的唯一ID最大长度:128
fromenumN/A资金转出账户bizType 枚举
toenumN/A资金转入账户bizType 枚举
currencystringN/A币种名称,必须小写(例如 usdtbtc
symbolstringN/A划转交易对(必须小写)。如果转入或转出账户中有一个是杠杆账户,则必填
amountbigDecimalN/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,建议保存用于对账
}