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"
}

Changes

Changed in 3 of the 26 revisions of this API.213

Apr 25, 2022f008d48ec6236See the full diff
- ○
  added the new optional query request parameter symbol
  new-optional-request-parameter
- ○
  added the new enum value ISOLATED_MARGIN to the query request parameter fromAccountType
  request-parameter-enum-value-added
- ○
  added the new enum value ISOLATED_MARGIN to the query request parameter toAccountType
  request-parameter-enum-value-added
- ○
  added the new enum value MARGIN to the query request parameter fromAccountType
  request-parameter-enum-value-added
- ○
  added the new enum value MARGIN to the query request parameter toAccountType
  request-parameter-enum-value-added
- ○
  added the required property clientTranId to the response with the 200 status
  response-required-property-added
Jan 7, 2022df4abe39a7f11See the full diff
- ○
  added the new optional query request parameter clientTranId
  new-optional-request-parameter
Oct 25, 2021a484ce871a7226See the full diff
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ○
  for the query request parameter amount, the type/format was generalized from number/float to number/double
  request-parameter-type-generalized
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required
- ○
  the response property tranId became required for the status 200
  response-property-became-required

Full history