Sub-Account

Sub-account Transfer History (For Sub-account)

If type is not sent, the records of type 2: transfer out will be returned by default.
If startTime and endTime are not sent, the recent 30-day data will be returned.

Weight(IP): 1

get/sapi/v1/sub-account/transfer/subUserHistory

Query parameters

assetstring

Example:BNB

typeinteger

1 - transfer in
2 - transfer out

startTimeinteger

UTC timestamp in ms

endTimeinteger

UTC timestamp in ms

limitinteger

Example:5

Default 500; max 1000.

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Transfer id

counterPartystring required

emailstring required

typeinteger required

1 for transfer in, 2 for transfer out

assetstring required

qtystring required

fromAccountTypestring required

toAccountTypestring required

statusstring required

tranIdinteger required

timeinteger required

Example response

[
  {
    "counterParty": "master",
    "email": "master@test.com",
    "type": 1,
    "asset": "BTC",
    "qty": "1",
    "fromAccountType": "SPOT",
    "toAccountType": "SPOT",
    "status": "SUCCESS",
    "tranId": 11798835829,
    "time": 1544433325000
  }
]

Changes

Changed in 2 of the 26 revisions of this API.814

Sep 19, 2023558ab69ec5552See the full diff
- ▲
  removed the enum value 1.00 from the query request parameter type
  request-parameter-enum-value-removed
- ▲
  removed the enum value 2.00 from the query request parameter type
  request-parameter-enum-value-removed
Oct 25, 2021a484ce871a72614See 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 limit, 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
- ▲
  for the query request parameter type, the type/format was changed from integer/ to integer/int32
  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/asset became required for the status 200
  response-property-became-required
- ○
  the response property items/counterParty became required for the status 200
  response-property-became-required
- ○
  the response property items/email 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/qty 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/time 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/tranId became required for the status 200
  response-property-became-required
- ○
  the response property items/type 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