Skip to main content
GET
Get aggregated balances

Authorizations

Authorization
string
header
required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"66f45dfc-558a-4c8f-95cd-a72aa997229d"

x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Query Parameters

accountTypes
string

Optional comma-separated list of account types to include. Valid values: Trading, Cash, Options, Crypto, MoneyFarm, Spaceship.

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

Aggregated balances 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.