Transfer Subaccount Balance

POST

https://api.onetrading.com/fast/v1/subaccounts/transfers

Transfers an amount of a single currency from one account to another, where both accounts belong to the authenticated account holder (the main account or any of its subaccounts).

The debit is applied to the source account first; if the credit to the destination fails, the debit is automatically rolled back.

Required API scope: SUBACCOUNT_TRANSFER. The API key presented in the Authorization: Bearer <token> header must carry this permission (keys with UI_HOLDER / UI_ACCOUNT permissions are also authorised).

Both source_account_id and destination_account_id must be owned by the caller and must be different from one another. Amount precision is truncated to 8 decimal places (3 for SHIB, PEPE and BTT).

Note

This endpoint does not allow transfers to and from the instant-trade account.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Transfer completed. Returns the outgoing transfer record.

Bodyapplication/json

🟠400Bad Request

🟠403Forbidden

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.onetrading.com/fast/v1/subaccounts/transfers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "100.00",
    "currency": "EUR",
    "source_account_id": "8f2b6c1e-0a9d-4c7e-9b21-2f5d3a1c4e6a",
    "destination_account_id": "3c7a1d40-6b2e-4f88-9a10-7e5c2b9f0d13"
}'

Response Example

200 - default

{
    "transfer": {
        "account_holder": "3c7a1d40-6b2e-4f88-9a10-7e5c2b9f0d13",
        "transfer_id": "5b9e2f10-8c4a-4d21-b6f7-1a2c3d4e5f60",
        "source_account_id": "8f2b6c1e-0a9d-4c7e-9b21-2f5d3a1c4e6a",
        "destination_account_id": "3c7a1d40-6b2e-4f88-9a10-7e5c2b9f0d13",
        "currency": "EUR",
        "amount": "100.00",
        "time": "2026-07-03T10:15:30.000Z"
    }
}

Get Futures Open Positions