Sub-Account

Universal Transfer History (For Master Account)

Changed on
  • fromEmail and toEmail cannot be sent at the same time.
  • Return fromEmail equal master account email by default.
  • The query time period must be less then 30 days.
  • If startTime and endTime not sent, return records of the last 30 days by default.

Weight(IP): 1

get/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

clientTranIdstring
startTimeinteger

UTC timestamp in ms

endTimeinteger

UTC timestamp in ms

pageinteger
Example:1

Default 1

limitinteger

Default 500, Max 500

recvWindowinteger
Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Transfer History

tranIdinteger required
fromEmailstring required
toEmailstring required
assetstring required
amountstring required
fromAccountTypestring required
toAccountTypestring required
statusstring required
createTimeStampinteger required
clientTranIdstring required

Example response

[
  {
    "tranId": 11945860693,
    "fromEmail": "master@test.com",
    "toEmail": "subaccount1@test.com",
    "asset": "BTC",
    "amount": "0.1",
    "fromAccountType": "SPOT",
    "toAccountType": "COIN_FUTURE",
    "status": "SUCCESS",
    "createTimeStamp": 1544433325000,
    "clientTranId": "11945860694"
  }
]

Changes

    • info

      added the required property / to the response with the status

    • breaking

      for the query request parameter limit, the type changed from string to integer, and format from no format to int32

    • info

      added the new optional query request parameter clientTranId