BIbinance
Sub-Account

Universal Transfer (For Master Account)

Changed on
  • 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

Request

  • Base URL
    https://api.binance.com
  • URL
    https://api.binance.com/sapi/v1/sub-account/universalTransfer
  • Auth
    API key in header X-MBX-APIKEY

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

  • f008d48ec623Revision changes
    • info

      added the new optional query request parameter symbol

    • info

      added the new enum value ISOLATED_MARGIN to the query request parameter fromAccountType

    • info

      added the new enum value ISOLATED_MARGIN to the query request parameter toAccountType

    • info

      added the new enum value MARGIN to the query request parameter fromAccountType

    • info

      added the new enum value MARGIN to the query request parameter toAccountType

    • info

      added the required property to the response with the status

  • df4abe39a7f1Revision changes
    • info

      added the new optional query request parameter clientTranId