Initiate an asset transfer between accounts. Supported transfer types include: Intra-exchange transfer, Cross-exchange transfer, Transfer between Funding Accounts and Trading Portfolios, Transfer between Trading Accounts. Note: Only API keys with Transfer permissions are authorized to call this endpoint.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
TipsApplies to both user and trading portfolio's API Key. Permission: TRANSFER.
Request
| Field name | Type | Necessary | Remarks |
|---|---|---|---|
| fromTradeAccountId | Long | Y | Outgoing Trade account ID (obtained through Trade account list) This field is applicable to Exchange account, Funding Account, CL Trading Account and Trading Portfolio's ID. |
| toTradeAccountId | Long | Y | Posting Trade account ID (obtained through Trade account list) This field is applicable to Exchange account, Funding Account, CL Trading Account and Trading Portfolio's ID. |
| fromAccountType | String | Conditional | Source account type. Required for a RapidX Trading Portfolio: BINANCE, OKX or EDX. For a DMA exchange account, choose the standardized V2 value for its exchange and account mode. Standardized V2 values are recommended on this V1 endpoint; existing supported V1 values remain compatible. See Account Types. |
| toAccountType | String | Conditional | Destination account type. Required for a RapidX Trading Portfolio: BINANCE, OKX or EDX. For a DMA exchange account, choose the standardized V2 value for its exchange and account mode. Standardized V2 values are recommended on this V1 endpoint; existing supported V1 values remain compatible. See Account Types. When toAccountType is Binance, there may be a delay of 0.5–1 hour due to the exchange. |
| currency | String | Y | Currency |
| network | String | N | This field is only effective for cross-exchange transfers and Funding Acct. related transfers. |
| amount | String | Y | Quantity (minimum amount :Depend on On-Chain or Exchange Precision Requirements) |
| rapidTransfer | Boolean | Conditional | Rapid Transfer currently supports USDT only, and applies to transfers between two trading accounts on the supported venues (Binance, RapidX, Bybit, OKX, Gate, Bitget, Deribit, Coinbase). Transfers involving your Funding Account are not eligible. If the pool at the receiving venue is short of quota, the request continues through the standard transfer flow instead of failing. See the Rapid Transfer guide. |
| clientOrderId | String | N | The unique user-defined id |
| loanTrans | Boolean | N | Only the trading account from OKX exchange supports this feature. Other accounts don't support this feature. |
Response
| Field name | Type | Remarks |
|---|---|---|
| transferId | Long | Transfer ID |
Details
1. API Key
| API Key | Permission |
|---|---|
| Primary user’s API Key | - Supports transfers between the funding account and all Trading Portfolios; - Supports transfers between all Trading Portfolios under the same primary user. |
| Trading Portfolio API Key: | - Only supports transfers between different exchanges within the API-owned Trading Portfolio. |
2. Account Type
See Account Types for the shared exchange-by-mode enum reference. Use the standardized V2 values for new integrations, including requests to this V1 endpoint. Existing supported V1 values remain compatible; for example, Binance MARGIN is accepted alongside MARGIN_CROSS.
For a DMA account, select the wallet type for its exchange and account mode. For a RapidX Portfolio, select BINANCE, OKX or EDX. Follow this endpoint’s rules for an LTP Funding Account. Enum compatibility does not change permissions or available routes.
Operational notes:
- Transfers involving Binance Portfolio Margin may take approximately one hour due to exchange processing.
- Switching a Gate account between Unified and Classic modes may take several minutes to half an hour to synchronize balances.
3. Network
TRC20, BTC, ERC20, BSC, etc. Please refer to the Get Currencies interface for more details.