Skip to main content
GET
/
api
/
v1
/
balances
/
{accountType}
Get balances by account type
curl --request GET \
  --url https://public-api.etoro.com/api/v1/balances/{accountType} \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "gcid": 123,
  "totalBalance": 123,
  "displayCurrency": "<string>",
  "balances": [
    {
      "accountId": "<string>",
      "subType": "<string>",
      "balance": 123,
      "currency": "<string>",
      "displayBalance": 123,
      "displayCurrency": "<string>",
      "exchangeRate": 123,
      "equityDetails": {
        "available": 123,
        "frozenCash": 123,
        "currentPNL": 123,
        "totalUsedMargin": 123,
        "cryptoId": 123,
        "balance": 123,
        "totalBalance": 123,
        "spendableBalance": 123,
        "balanceInFiat": 123,
        "totalBalanceInFiat": 123,
        "spendableBalanceInFiat": 123,
        "fiatConversionCurrency": "<string>",
        "orderIndex": 123
      }
    }
  ]
}

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"9bad2f6e-2179-4c3a-9a08-c80b5237d80b"

x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

accountType
enum<string>
required

The account type to retrieve balances for.

Available options:
trading,
options,
cash

Query Parameters

accountIds
string

Optional comma-separated list of account IDs to include.

displayCurrency
string
default:USD

ISO 4217 currency code for totals and conversions. Defaults to USD.

includeZeroBalances
boolean

Whether to include accounts with a zero balance in the response. Defaults to false.

expand
string

Comma-separated list of optional sections to include in the response. Valid values: equityDetails.

Response

Balances for the specified account type retrieved successfully.

Aggregated balances for the authenticated user.

gcid
integer<int64>

The user's global customer ID.

totalBalance
number<double>

Sum of all account balances converted to the requested display currency.

displayCurrency
string | null

ISO 4217 currency code used for totalBalance and displayBalance values.

balances
object[] | null

Individual account balances.