Sub-Account

Universal Transfer History (For Master Account)

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

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

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

Apr 25, 2022f008d48ec6231See the full diff
- ○
  added the required property items/clientTranId to the response with the 200 status
  response-required-property-added
Jan 7, 2022df4abe39a7f111See the full diff
- ▲
  for the query request parameter limit, the type/format was changed from string/ to integer/int32
  request-parameter-type-changed
- ○
  added the new optional query request parameter clientTranId
  new-optional-request-parameter
Oct 25, 2021a484ce871a72513See the full diff
- ▲
  for the query request parameter endTime, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter page, the type/format was changed from integer/ to integer/int32
  request-parameter-type-changed
- ▲
  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 startTime, 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
- ○
  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 items/amount became required for the status 200
  response-property-became-required
- ○
  the response property items/asset became required for the status 200
  response-property-became-required
- ○
  the response property items/createTimeStamp became required for the status 200
  response-property-became-required
- ○
  the response property items/fromAccountType became required for the status 200
  response-property-became-required
- ○
  the response property items/fromEmail became required for the status 200
  response-property-became-required
- ○
  the response property items/status became required for the status 200
  response-property-became-required
- ○
  the response property items/toAccountType became required for the status 200
  response-property-became-required
- ○
  the response property items/toEmail became required for the status 200
  response-property-became-required
- ○
  the response property items/tranId became required for the status 200
  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

Full history