> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/assets-withdraw-settle-pnl/get-internal-transfer-history.md).

# Get Internal Transfer History

## Get Internal Transfer History

Returns internal transfer history for the authenticated account.

### Endpoint

**GET /v1/internal\_transfer\_history**

Mainnet: GET <https://api.orderly.org/v1/internal\\_transfer\\_history\\>
Testnet: GET <https://testnet-api.orderly.org/v1/internal\\_transfer\\_history>

Rate limit: 10 requests per second.

### Headers

* `orderly-timestamp` (string, required): Signed request timestamp in milliseconds.
* `orderly-account-id` (string, required): Authenticated account ID.
* `orderly-key` (string, required): Public key used to sign the request.
* `orderly-signature` (string, required): Signature of the request payload.

### Query parameters

* `status` (string): Filter by `CREATED`, `PENDING`, `COMPLETED`, or `FAILED`.
* `start_t` (string): Start time filter.
* `end_t` (string): End time filter.
* `page` (number): Page number, starting at 1.
* `size` (number): Number of records per page.
* `side` (string, required): `IN` or `OUT`.
* `from_account_id` (string): Filter by sender account.
* `to_account_id` (string): Filter by recipient account.
* `main_sub_only` (boolean): `true` returns transfers between the main account and its sub-accounts; `false` returns transfers between the main account and other main accounts; omit to return all transfer history.

### Response

HTTP 200 returns `success`, `data.meta`, `data.rows`, and `timestamp`. Metadata contains `total`, `records_per_page`, and `current_page` (starting at 1). Each row can contain `internal_transfer_request_id` (number), `id` (string), `token` (string), `amount` (number), `from_account_id` and `to_account_id` (strings), `status` (string), and `created_time` and `updated_time` (numbers in milliseconds).

```
{"success":true,"data":{"meta":{"total":9,"records_per_page":25,"current_page":1},"rows":[{"internal_transfer_request_id":123,"id":"230707030600002","token":"USDC","amount":555,"from_account_id":"0x000000","to_account_id":"0x000000","status":"FAILED","created_time":1688699193034,"updated_time":1688699193034}]},"timestamp":1702989203989}
```
