v26

latestOpenAPI 3.0.2raw.githubusercontent.com2024-10-0834042975.6 KB
Sub-Account

Universal Transfer (For Master Account)

  • You need to enable "internal transfer" option for the api key which requests this endpoint.
  • Transfer from master account by default if fromEmail is not sent.
  • Transfer to master account by default if toEmail is not sent.
  • Supported transfer scenarios:
    • Master account SPOT transfer to sub-account SPOT,USDT_FUTURE,COIN_FUTURE,MARGIN(Cross),ISOLATED_MARGIN
    • Sub-account SPOT,USDT_FUTURE,COIN_FUTURE,MARGIN(Cross),ISOLATED_MARGIN transfer to master account SPOT
    • Transfer between two sub-account SPOT accounts

Weight(IP): 1

post/sapi/v1/sub-account/universalTransfer

Query parameters

fromEmailstring

Sub-account email

toEmailstring

Sub-account email

fromAccountType'SPOT' | 'USDT_FUTURE' | 'COIN_FUTURE' | 'MARGIN' | 'ISOLATED_MARGIN' required
toAccountType'SPOT' | 'USDT_FUTURE' | 'COIN_FUTURE' | 'MARGIN' | 'ISOLATED_MARGIN' required
clientTranIdstring
symbolstring
Example:BNBUSDT

Only supported under ISOLATED_MARGIN type

assetstring required
Example:BTC
amountnumber double required
recvWindowinteger
Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Transfer id

tranIdinteger required
clientTranIdstring required

Example response

{
  "tranId": 11945860693,
  "clientTranId": "11945860694"
}