Skip to main content

Get Transfer Records between Sub-Accounts

Info
  • This endpoint requires signature. For specific signature rules, please refer to Authentication
  • This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.
Reminder
  • This endpoint can only be accessed using the ACCESS ID of the main account

HTTP request

GET /account/subs/transfer-history

Request parameters

Parameter NameRequiredTypeNotes
sub_user_namefalsestringSub-account username
ccyfalsestringCurrency name
start_timefalseintQuery start time.
  • Data will not be filtered based on time by default
end_timefalseintQuery end time.
  • Data will not be filtered based on time by default
pagefalseintNumber of pagination. Default is 1
limitfalseintNumber in each page. Default is 10

Return parameters

Parameter NameTypeNotes
created_atintTransfer application time
from_account_typestringSender's account type
to_account_typestringReceiver's account type
from_user_namestringUsername of the sending sub-account
to_user_namestringUsername of the receiving sub-account
ccystringCurrency name
amountstringTransfer amount
statusstringTransfer status

Request example

GET /account/subs/transfer-history?sub_user_name=sub2&ccy=CET&start_time=1636451914231&page=1&limit=100

Response example

{
"code": 0,
"message": "OK",
"data": [
{
"created_at": 1636443179213,
"from_user_name": "sub1",
"to_user_name": "sub2",
"from_account_type": "SPOT",
"to_account_type": "SPOT",
"ccy": "USDT",
"amount": "1",
"status": "FINISHED"
}
],
"pagination": {
"total": 1,
"has_next": false
}
}