Skip to main content
GET
Get balance for a specific account

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:

"b1fa4f14-f5b9-4c87-8775-377380f30ec3"

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. The type of eToro account.

Available options:
Trading,
Cash,
Options,
Crypto,
MoneyFarm,
Spaceship
accountId
string
required

The unique identifier of the account.

Query Parameters

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

Balance for the specified account 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.