Skip to main content

Asset Transfer between Sub-Accounts

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.
Reminder
  • This endpoint can only be accessed using the ACCESS ID of the main account
  • Transfers between sub-accounts are only allowed from spot to spot accounts

HTTP request

POST /account/subs/transfer

Request parameters

Info
  • Provide at least one request parameters, from_user_name or to_user_name
  • If from_user_name is null, the default is to transfer from the main account
  • If to_user_name is null, the default is to transfer to the main account
  • If the transfer is between two sub-accounts, it can only be transferred from spot account to another spot account
Parameter NameRequiredTypeNotes
from_account_typetruestringSender's account type.
  • SPOT: Spot account
  • FUTURES: Futures account
to_account_typetruestringReceiver's account type.
  • SPOT: Spot account
  • FUTURES: Futures account
from_user_namefalsestringUsername of the sending sub-account.
to_user_namefalsestringUsername of the receiving sub-account.
ccytruestringCurrency name
amounttruestringTransfer amount

Return parameters

None


Request example

{
"from_user_name": "sub1",
"to_user_name": "sub2",
"from_account_type": "SPOT",
"to_account_type": "SPOT",
"ccy": "USDT",
"amount": "1"
}

Response example

{
"code": 0,
"message": "OK",
"data": {}
}