v1
latestOpenAPI 3.0.32026-07-2613529376.3 KBSub-Account
Get Sub-Account Transfer History
The endpoint returns history of transfers between main account and sub-account.
<Warning> Rate limit: 1000 requests/10 sec. </Warning> <Note> The API does not cache the response. </Note> <Note> Results are sorted by transaction id descending (newest transfer first). The response is a plain array with no `total`, `has_more`, or cursor — a returned count below `limit` marks the last page (an empty array means no further records). </Note> <Note> **No date filtering:** the endpoint does not accept `startDate` / `endDate` parameters, and pagination is capped at `offset + limit ≤ 10000` (`limit` ≤ 100). The required `id` parameter already scopes results to a single sub-account; for a complete history export beyond the cap, use the Report on the History page. </Note>post/api/v4/sub-account/transfer/history
Request body
Example request
{
"id": "8e667b4a-0b71-4988-8af5-9474dbfaeb51",
"direction": "main_to_sub",
"limit": 100
}Response
Successful response
Example response
{
"data": [
{
"transaction_id": "tx-abc123",
"id": "tx-abc123",
"direction": "main_to_sub",
"currency": "ETH",
"amount": "0.5",
"createdAt": 1641081600
}
]
}