Transfer between user business systems
Type: POST
Description: /v4/balance/transfer
Parameters
| name | type | mandatory | default | description | ranges |
|---|---|---|---|---|---|
| bizId | string | true | N/A | Unique ID for idempotent processing | Maximum length: 128 |
| from | enum | true | N/A | Fund transfer out account | bizType enum |
| to | enum | true | N/A | Fund transfer in account | bizType enum |
| currency | string | true | N/A | Currency name, must be lowercase (e.g. usdt, btc) | |
| symbol | string | false | N/A | Transfer symbol (must be lowercase). Required if one of the transfer-in or transfer-out accounts is leverage | |
| amount | bigDecimal | true | N/A | Transfer amount |
Notes
This endpoint allows fund transfers between different business systems under the same user.
bizIdensures idempotent processing, recommended to be stored for reconciliation.- If leverage accounts are involved,
symbolmust be provided.
Parameters Example
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"
}'
Response Example
Response
{
"rc": 0,
"mc": "SUCCESS",
"ma": [],
"result": 123456 // The returned unique ID of the transfer, recommended to store for reconciliation
}