> 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/create-internal-transfer.md).

# Create Internal Transfer

### Endpoint

`POST /v1/internal_transfer`

Mainnet: `https://api.orderly.org/v1/internal_transfer`

Testnet: `https://testnet-api.orderly.org/v1/internal_transfer`

Rate limit: 10 requests per 1 second.

Creates an internal transfer. This endpoint returns an error if the sender is a Delegate Signer account.

Transfers are supported between main and sub-accounts, accounts in the same wallet group, the same address across brokers, a whitelisted account ID used as the sender, or two accounts under the same broker when that broker is whitelisted.

### Authentication

Send the signed-request headers with an `application/json` body.

* `orderly-timestamp` — required; signed-request timestamp in milliseconds.
* `orderly-account-id` — required; authenticated account ID.
* `orderly-key` — required; public API key.
* `orderly-signature` — required; signature generated for the request.

### Request body

* `token` (string) — token to transfer; example `USDC`.
* `receiver_list` (array) — up to 50 recipients per request. A transfer to yourself fails. Each item contains `account_id` (string) and `amount` (number).

### Response

HTTP 200 — application/json. `success` is a required boolean. `data` may contain `internal_transfer_request_id` (integer). The root `timestamp` is server time in milliseconds (integer).

```
{
  "success": true,
  "timestamp": 1702989203989,
  "data": { "internal_transfer_request_id": 123 }
}
```
