---
title: "Get aggregated balances"
method: GET
path: "/api/v1/balances"
tags: ["Balances"]
---

# Get aggregated balances

`GET /api/v1/balances`

**Rate limit:** 60 requests per 60 seconds. This is the **default shared quota** — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

---

Returns aggregated balances across all account types for the authenticated user. Optionally filter by account type or specify the display currency for totals.

## Query parameters

- `accountTypes` string
- `displayCurrency` string
- `includeZeroBalances` boolean
- `expand` string

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required

## Response `200`

Aggregated balances retrieved successfully.

- GetBalancesResponse — Aggregated balances for the authenticated user.
  - `gcid` integer — The user's global customer ID.
  - `totalBalance` number, double — Sum of all account balances converted to the requested display currency.
  - `displayCurrency` string, nullable — ISO 4217 currency code used for totalBalance and displayBalance values.
  - `balances` AccountBalanceData[], nullable — Individual account balances.
    - `accountId` string, nullable — Unique identifier of the account.
    - `accountType` 'Trading' | 'Cash' | 'Options' | 'Crypto' | 'MoneyFarm' | 'Spaceship' — The type of eToro account.
    - `subType` string, nullable — Account sub-type, where applicable.
    - `balance` number, double — Account balance in the account's native currency.
    - `currency` string, nullable — The account's native currency (ISO 4217).
    - `displayBalance` number, double — Account balance converted to the requested display currency.
    - `displayCurrency` string, nullable — The display currency (ISO 4217) used for displayBalance.
    - `exchangeRate` number, double — Exchange rate applied to convert balance to displayCurrency.
    - `equityDetails` EquityDetailsData — Provider-specific balance details, returned only when the request includes expand=equityDetails. All fields are nullable; only fields relevant to the account's provider are populated. Trading accounts populate available/frozenCash/currentPNL/totalUsedMargin; Crypto accounts populate cryptoId, the balance variants, fiatConversionCurrency, and orderIndex.
      - `available` number, double, nullable — Available balance or buying power (Trading, Options, MoneyFarm, Cash).
      - `frozenCash` number, double, nullable — Cash frozen by the platform pending settlement (Trading).
      - `currentPNL` number, double, nullable — Current unrealized profit and loss on open positions (Trading).
      - `totalUsedMargin` number, double, nullable — Total margin used by open positions (Trading).
      - `cryptoId` integer, nullable — eToro internal crypto asset identifier (Crypto).
      - `balance` number, double, nullable — Balance in native crypto units (Crypto).
      - `totalBalance` number, double, nullable — Total balance in native crypto units, including pending (Crypto).
      - `spendableBalance` number, double, nullable — Spendable balance in native crypto units (Crypto).
      - `balanceInFiat` number, double, nullable — Balance converted to fiat (Crypto).
      - `totalBalanceInFiat` number, double, nullable — Total balance converted to fiat, including pending (Crypto).
      - `spendableBalanceInFiat` number, double, nullable — Spendable balance converted to fiat (Crypto).
      - `fiatConversionCurrency` string, nullable — ISO 4217 currency code used for the InFiat values (Crypto).
      - `orderIndex` integer, nullable — Display order index for sorting (Crypto).

## Other responses

- `400` — Bad Request — invalid query parameter value.
- `401` — Unauthorized — missing or invalid authentication credentials.
- `403` — Forbidden — the token does not include the etoro-public:money.balance:read scope.
- `429` — Too Many Requests — rate limit exceeded.
- `500` — Internal Server Error.

---

[API](https://skmtc.net/etoro/apis/etoro-api.md) · [All operations](https://skmtc.net/etoro/apis/etoro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/etoro/etoro-api/revisions/69c1fb266c35/schema)