Skip to main content
GET
/
api
/
v1
/
balances
/
{accountType}
/
{accountId}
/
history
Get historical balances for a specific account
curl --request GET \
  --url https://public-api.etoro.com/api/v1/balances/{accountType}/{accountId}/history \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "gcid": 123,
  "displayCurrency": "<string>",
  "fromDate": "2023-12-25",
  "toDate": "2023-12-25",
  "snapshots": [
    {
      "date": "2023-12-25",
      "totalCurrencyIso": "<string>",
      "totalCash": 123,
      "totalInvestedAmount": 123,
      "totalPnl": 123,
      "totalBalance": 123,
      "displayTotalCash": 123,
      "displayTotalInvestedAmount": 123,
      "displayTotalPnl": 123,
      "displayTotalBalance": 123,
      "totalExchangeRate": 123,
      "accountSnapshots": [
        {
          "accountId": "<string>",
          "currency": "<string>",
          "cash": 123,
          "investedAmount": 123,
          "pnl": 123,
          "total": 123,
          "usdRate": 123,
          "displayCash": 123,
          "displayInvestedAmount": 123,
          "displayPnl": 123,
          "displayTotal": 123,
          "exchangeRate": 123
        }
      ]
    }
  ]
}

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"2faf6249-c7ab-4057-9760-923619a1a280"

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.

Available options:
trading,
options,
cash
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.

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.