v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB
Sub-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

idstring required

Sub-account id

direction'main_to_sub' | 'sub_to_main'

Transfer direction (optional)

limitinteger
offsetinteger

Example request

{
  "id": "8e667b4a-0b71-4988-8af5-9474dbfaeb51",
  "direction": "main_to_sub",
  "limit": 100
}

Response

Successful response

offsetinteger
limitinteger

Example response

{
  "data": [
    {
      "transaction_id": "tx-abc123",
      "id": "tx-abc123",
      "direction": "main_to_sub",
      "currency": "ETH",
      "amount": "0.5",
      "createdAt": 1641081600
    }
  ]
}