---
title: "Get Sub-Account Transfer History"
method: POST
path: "/api/v4/sub-account/transfer/history"
tags: ["Sub-Account"]
---

# Get Sub-Account Transfer History

`POST /api/v4/sub-account/transfer/history`

The endpoint returns history of transfers between main account and [sub-account](/glossary#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>

## Request body

- object
  - `id` string, required — Sub-account id
  - `direction` 'main_to_sub' | 'sub_to_main' — Transfer direction (optional)
  - `limit` integer
  - `offset` integer

## Response `200`

Successful response

- object
  - `offset` integer
  - `limit` integer
  - `data` SubAccountTransfer[]
    - `transaction_id` string — Transaction identifier. Same value as id. Correlate with the transfer endpoint response using the transaction_id field.
    - `id` string — Transfer identifier
    - `direction` string — Transfer direction (main_to_sub or sub_to_main)
    - `currency` string — Currency transferred
    - `amount` string — Transfer amount
    - `createdAt` integer — Transfer creation timestamp

## Other responses

- `422` — Account is not confirmed

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)