Subaccounts

GET

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

Returns every account owned by the authenticated account holder: the main account first, then each subaccount, with each account's balances and futures margin totals.

The list always covers the whole account holder, even when the token acts on a subaccount. Subaccounts that have been closed are included with state: CLOSED. The main account is returned with name: main, state: ACTIVE and a placeholder created of 1970-01-01T00:00:00.000Z.

account_equity, margin_used and margin_available are expressed in USD, the collateral currency for futures. If balances cannot be retrieved from the exchange for an account, that account has an empty balances array and "0" for the account totals.

Required API scope: any valid API key. This endpoint is not rate-limited and takes no query parameters.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200Success

application/json

The main account followed by every subaccount of the account holder.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.onetrading.com/fast/v1/subaccounts' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success Example

{
    "account_holder": "50034b63-9607-4801-810a-6ab00d185eca",
    "subaccounts": [
        {
            "account_id": "50034b63-9607-4801-810a-6ab00d185eca",
            "state": "ACTIVE",
            "name": "main",
            "created": "1970-01-01T00:00:00.000Z",
            "account_equity": "171.83539848",
            "margin_available": "171.83539848",
            "margin_used": "0",
            "balances": [
                {
                    "currency_code": "EUR",
                    "available": "85.80718666",
                    "locked": "0",
                    "time": "2026-10-06T09:12:44.513Z"
                },
                {
                    "currency_code": "BTC",
                    "available": "0.00015998",
                    "locked": "0",
                    "time": "2026-10-06T09:12:44.513Z"
                },
                {
                    "currency_code": "USDC",
                    "available": "50.5359915",
                    "locked": "10",
                    "time": "2026-10-06T09:12:44.513Z"
                }
            ]
        },
        {
            "account_id": "8f2b6c1e-0a9d-4c7e-9b21-2f5d3a1c4e6a",
            "state": "ACTIVE",
            "name": "market-making",
            "created": "2026-03-14T08:21:05.112Z",
            "account_equity": "2500.00",
            "margin_available": "1875.40",
            "margin_used": "624.60",
            "balances": [
                {
                    "currency_code": "USDC",
                    "available": "2500",
                    "locked": "0",
                    "time": "2026-10-06T09:12:44.513Z"
                }
            ]
        },
        {
            "account_id": "3c7a1d40-6b2e-4f88-9a10-7e5c2b9f0d13",
            "state": "CLOSED",
            "name": "old-strategy",
            "created": "2025-11-02T16:40:19.870Z",
            "account_equity": "0",
            "margin_available": "0",
            "margin_used": "0",
            "balances": []
        }
    ]
}

Balances

Fees