Skip to main content
GET
Get account balance history

Authorizations

x-api-key
string
header
default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key
string
header
default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"3345cd05-7d66-4d2a-b98f-54706c0d1076"

Path Parameters

accountType
enum<string>
required

The account type. Must be lowercase — any other casing does not match the route and returns 404. The type of eToro account, as accepted in the accountType path segment. Lowercase only: the route matches these values exactly and returns 404 for any other casing or for numeric values. Note this differs from the casing used for accountType in response bodies.

Available options:
trading,
cash,
options,
crypto,
moneyfarm,
spaceship
Example:

"trading"

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.

fromDate
string<date>

Start of the date range (inclusive). Format: YYYY-MM-DD (ISO 8601). Defaults to toDate minus 30 days. Must be within the last 12 months. Maximum range with toDate: 365 days.

toDate
string<date>

End of the date range (inclusive). Format: YYYY-MM-DD (ISO 8601). Defaults to today (UTC). Maximum range with fromDate: 365 days.

includeSubAccounts
boolean
default:false

Whether to also include the user's qualifying sub-accounts in the aggregated history. Their end-of-day snapshots are merged by date with the primary account's and the daily totals are recalculated across all accounts. Only effective when the accountType path segment is trading; ignored for every other account type. Defaults to false.

Response

Historical balance snapshots for the specified account retrieved successfully.

Historical end-of-day balance snapshots for the authenticated user.

gcid
integer<int64>

The user's global customer ID.

displayCurrency
string | null

ISO 4217 currency code used for display values.

fromDate
string<date>

Start of the returned date range (inclusive, ISO 8601).

toDate
string<date>

End of the returned date range (inclusive, ISO 8601).

snapshots
object[] | null

End-of-day balance snapshots, one entry per day in the requested range.