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

# Sub-Account Transfer

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

The endpoint creates transfer from main account to [sub-account](/glossary#sub-account) or vice versa.

<Warning>
Rate limit: 1000 requests/10 sec.
</Warning>

<Note>
The API does not cache the response.
</Note>

## Request body

- object
  - `id` string, required — Sub-account id
  - `direction` 'main_to_sub' | 'sub_to_main', required — Transfer direction
  - `amount` string, required — Transfer amount (min 0.00000001)
  - `ticker` string, required — Currency's [ticker](/glossary#ticker)

## Response `200`

Transfer successful

- object
  - `transaction_id` string — External identifier of the transaction. Correlate transfer history responses using the `transaction_id` value.

## Other responses

- `400` — Request validation failed

---

[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)