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 }
}