> 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-with-wallet-signature.md).

# Create Internal Transfer with Wallet Signature

### Endpoint

`POST /v2/internal_transfer`

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

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

Rate limit: 10 requests per 1 second.

Creates an internal transfer using a wallet signature.

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

The schema lists these fields without marking them as required:

* `signature` (string).
* `userAddress` (string).
* `verifyingContract` (string).
* `message` (object), containing:
  * `receiver` (string).
  * `token` (string).
  * `amount` (integer); example `123`.
  * `transferNonce` (string).
  * `chainId` (string); example `"1"`.
  * `chainType` (enum string): `EVM` or `SOL`; example `SOL`.

### Response

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

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