> ## Documentation Index > Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt > Use this file to discover all available pages before exploring further. # Get balance for a specific account > **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 the balance for a specific account identified by type and account ID for the authenticated user. Zero-balance accounts are always returned by this endpoint, so a 404 means the account does not exist rather than that its balance is zero. Important: totalBalance and displayBalance are portfolio value, not spendable cash. For Trading, Options, MoneyFarm, Spaceship and Plaee they represent total account value including invested positions; for Crypto, the fiat value of holdings. Only for Cash accounts do they equal available cash. Do not use them to decide whether a trade or withdrawal is affordable — request expand=equityDetails and read equityDetails.available (Trading, Options, MoneyFarm, Cash, Plaee) or equityDetails.spendableBalanceInFiat (Crypto). Spaceship accounts expose no spendable figure. Note that equityDetails amounts are denominated in each account's own native currency, not in displayCurrency, so they must be converted before being compared with displayBalance or totalBalance. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/balances/{accountType}/{accountId} openapi: 3.0.1 info: title: eToro Api version: v1.393.0 description: >- eToro’s public API provides access to real-time financial data, trading insights, and account management features, allowing developers to integrate eToro’s services into their applications. With access to market prices, historical data, and social trading information, the API empowers users to enhance their trading strategies. Designed for security and scalability, the eToro API ensures smooth and reliable integration for a variety of financial applications. For more details on integrating with eToro's public WebSocket service, please refer to the dedicated [WebSocket documentation](./websocket/websocket-doc.html). ## Authentication Every request must be authenticated with exactly one of two options: an OAuth 2.0 access token (`Authorization: Bearer `), or the non-interactive credential pair (`x-api-key` + `x-user-key` headers). The two options are mutually exclusive — a request carrying both is rejected. Each operation lists the OAuth scopes that grant access as alternative security requirements: a bearer token needs only ONE of them, and the same permissions govern the credential pair. servers: - url: https://public-api.etoro.com description: eToro Public API security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: [] tags: - name: Agent Portfolios - name: Social Feeds - name: Balances - name: Clubs - name: Watchlists - name: Data - name: Top Assets - name: App Data - name: Market Data - name: Identity - name: Cash Accounts - name: Transfer - name: Notifications - name: PI Data - name: PortfolioSearch - name: Price Alerts - name: SSO - Applications - name: SSO - Scopes - name: Sub-Accounts - eToro Trading - name: Sub-Accounts - name: Trading - Demo - name: Trading - Real - name: Users Info - name: Rankings - name: User Stats - name: Copy Trading - name: Copy Trading - Demo paths: /api/v1/balances/{accountType}/{accountId}: get: tags: - Balances summary: Get balance for a specific account description: >- **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 the balance for a specific account identified by type and account ID for the authenticated user. Zero-balance accounts are always returned by this endpoint, so a 404 means the account does not exist rather than that its balance is zero. Important: totalBalance and displayBalance are portfolio value, not spendable cash. For Trading, Options, MoneyFarm, Spaceship and Plaee they represent total account value including invested positions; for Crypto, the fiat value of holdings. Only for Cash accounts do they equal available cash. Do not use them to decide whether a trade or withdrawal is affordable — request expand=equityDetails and read equityDetails.available (Trading, Options, MoneyFarm, Cash, Plaee) or equityDetails.spendableBalanceInFiat (Crypto). Spaceship accounts expose no spendable figure. Note that equityDetails amounts are denominated in each account's own native currency, not in displayCurrency, so they must be converted before being compared with displayBalance or totalBalance. operationId: getBalanceByAccount parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: 4f035f91-7a1f-443a-9426-c5013560bc91 description: A unique request identifier. example: 4f035f91-7a1f-443a-9426-c5013560bc91 - name: accountType in: path required: true description: >- The account type. Must be lowercase — any other casing does not match the route and returns 404. schema: $ref: '#/components/schemas/AccountTypePathParam' - name: accountId in: path required: true description: The unique identifier of the account. schema: type: string - name: displayCurrency in: query description: ISO 4217 currency code for totals and conversions. Defaults to USD. schema: type: string default: USD - name: expand in: query description: >- Comma-separated list of optional sections to include in the response. Valid values: equityDetails. schema: type: string responses: '200': description: Balance for the specified account retrieved successfully. content: application/json: schema: $ref: '#/components/schemas/GetBalancesResponse' headers: RateLimit-Limit: description: >- Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget. schema: type: integer example: 60 RateLimit-Remaining: description: Requests remaining in the current window for this quota. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer RateLimit-Policy: description: Quota policy in the form `;w=`. schema: type: string example: 60;w=60 '400': description: Bad Request — invalid account type or account ID. content: application/json: schema: $ref: '#/components/schemas/BalancesErrorResponse' '401': description: Unauthorized — missing or invalid authentication credentials. content: application/json: schema: $ref: '#/components/schemas/BalanceAggregatorApi_PublicErrorResponse' example: errorCode: Unauthorized errorMessage: Unauthorized '403': description: >- Forbidden — the token does not include the etoro-public:money.balance:read scope. '404': description: Not Found — no account found for the specified type and account ID. '429': description: Too Many Requests — rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/BalanceAggregatorApi_PublicErrorResponse' example: errorCode: TooManyRequests errorMessage: Too many requests headers: RateLimit-Limit: description: >- Maximum number of requests allowed per window. This is the default shared pool used by every endpoint without a dedicated limit, so it is NOT per-endpoint — requests across those endpoints all draw from this one budget. schema: type: integer example: 60 RateLimit-Remaining: description: Requests remaining in the current window for this quota. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer RateLimit-Policy: description: Quota policy in the form `;w=`. schema: type: string example: 60;w=60 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 60 '500': description: Internal Server Error. content: application/json: schema: $ref: '#/components/schemas/BalanceAggregatorApi_PublicErrorResponse' example: errorCode: UnhandledException errorMessage: Global Error '502': description: >- Bad Gateway — the upstream balance provider for this account type is unavailable or returned an error. The balance could not be determined; do not treat this as a zero balance. Safe to retry. content: application/json: schema: $ref: '#/components/schemas/BalancesErrorResponse' security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: - etoro-public:money.balance:read components: schemas: AccountTypePathParam: type: string description: >- 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. enum: - trading - cash - options - crypto - moneyfarm - spaceship - plaee example: trading GetBalancesResponse: type: object description: Aggregated balances for the authenticated user. properties: gcid: type: integer format: int64 description: The user's global customer ID. totalBalance: type: number format: double description: >- Sum of every included account's balance, converted to the requested display currency. Treat this as portfolio value, not spendable cash: for Trading, Options, MoneyFarm, Spaceship and Plaee it is the total account value including invested positions, and for Crypto it is the fiat value of holdings. For Trading specifically it equals equityDetails.available + equityDetails.totalUsedMargin + equityDetails.currentPNL, so it includes margin deployed in open positions and unrealized profit and loss — the available portion can be a small fraction of it. Only for Cash accounts does it equal available cash. Do not use it to decide whether a trade or withdrawal is affordable — request expand=equityDetails and read equityDetails.available (Trading, Options, MoneyFarm, Cash, Plaee) or equityDetails.spendableBalanceInFiat (Crypto). Spaceship accounts expose no spendable figure. Note that equityDetails amounts are denominated in each account's own native currency, not in displayCurrency, so they must be converted before being compared with displayBalance or totalBalance. displayCurrency: type: string nullable: true description: >- ISO 4217 currency code used for totalBalance and displayBalance values. balances: type: array items: $ref: '#/components/schemas/AccountBalanceData' nullable: true description: Individual account balances. additionalProperties: false BalancesErrorResponse: type: object description: Error response returned for client-side errors (4xx). properties: code: type: string nullable: true description: Error code (e.g., VALIDATION_ERROR, USER_NOT_FOUND). message: type: string nullable: true description: Human-readable error message. requestId: type: string nullable: true description: Request ID for tracing and support. additionalProperties: false BalanceAggregatorApi_PublicErrorResponse: type: object description: Standard error response returned by the API gateway. properties: errorCode: type: string nullable: true description: Error code. errorMessage: type: string nullable: true description: Human-readable error message. additionalProperties: false AccountBalanceData: type: object description: Balance data for a single account. properties: accountId: type: string nullable: true description: Unique identifier of the account. accountType: $ref: '#/components/schemas/BalanceAggregatorApi_AccountType' subType: type: string nullable: true description: Account sub-type, where applicable. balance: type: number format: double description: >- Account balance in the account's native currency (see the currency field). Its meaning depends on accountType: total account value including invested positions for Trading, Options, MoneyFarm, Spaceship and Plaee (for Plaee: cash plus the mark-to-market value of open prediction-market positions); holdings in native crypto units for Crypto; available cash for Cash. For Trading it equals equityDetails.available + equityDetails.totalUsedMargin + equityDetails.currentPNL. Not a spendable amount except on Cash accounts — see equityDetails.available. currency: type: string nullable: true description: The account's native currency (ISO 4217). displayBalance: type: number format: double description: >- Account balance converted to the requested display currency. Carries the same per-accountType meaning as balance, and is likewise not a spendable amount except on Cash accounts. displayCurrency: type: string nullable: true description: The display currency (ISO 4217) used for displayBalance. exchangeRate: type: number format: double description: Exchange rate applied to convert balance to displayCurrency. equityDetails: $ref: '#/components/schemas/EquityDetailsData' additionalProperties: false BalanceAggregatorApi_AccountType: type: string description: The type of eToro account, as returned in response bodies. enum: - Trading - Cash - Options - Crypto - MoneyFarm - Spaceship - Plaee EquityDetailsData: type: object description: >- 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; Spaceship accounts return no equityDetails object at all; Plaee accounts populate available (withdrawable cash), frozenCash (cash reserved by resting prediction-market orders), currentPNL (unrealised profit and loss on open positions), balance (cash) and totalBalance (cash plus open positions), all in the account currency, plus hasOpenPositions (true when an open position or a resting order exists at Plaee). Currency: the fiat amounts here are denominated in the enclosing account's native currency (its currency field), not in displayCurrency — the object carries no currency marker of its own. The exception is the *InFiat crypto fields, which use fiatConversionCurrency. properties: available: type: number format: double nullable: true description: >- Funds available to trade or withdraw (buying power). This is the correct field for pre-trade affordability checks — use it instead of totalBalance or displayBalance. IMPORTANT: this value is denominated in the account's native currency (the sibling currency field), NOT in displayCurrency, and no currency is stated inside equityDetails itself. Convert it before comparing against displayBalance, totalBalance, or any amount in the display currency — for example a GBP Cash account reports available in GBP while displayBalance is in USD. Populated for Trading, Options, MoneyFarm, Cash and Plaee (where it is the withdrawable cash) only; for Crypto use spendableBalanceInFiat instead, and Spaceship accounts return no equityDetails at all. For Cash accounts this equals the account's balance. frozenCash: type: number format: double nullable: true description: >- Cash frozen by the platform pending settlement. Already accounted for within the other figures — do not add it to balance, which is available + totalUsedMargin + currentPNL (Trading). For Plaee accounts this is the cash reserved by resting prediction-market orders. currentPNL: type: number format: double nullable: true description: >- Current unrealized profit and loss on open positions (Trading, Plaee). totalUsedMargin: type: number format: double nullable: true description: Total margin used by open positions (Trading). cryptoId: type: integer format: int32 nullable: true description: eToro internal crypto asset identifier (Crypto). balance: type: number format: double nullable: true description: >- Balance in native crypto units (Crypto); cash in the account currency (Plaee). totalBalance: type: number format: double nullable: true description: >- Total balance in native crypto units, including pending (Crypto); cash plus open positions (Plaee). spendableBalance: type: number format: double nullable: true description: >- Spendable balance in native crypto units — not a currency amount. Use spendableBalanceInFiat for a value comparable to other accounts (Crypto). balanceInFiat: type: number format: double nullable: true description: Balance converted to fiat (Crypto). totalBalanceInFiat: type: number format: double nullable: true description: Total balance converted to fiat, including pending (Crypto). spendableBalanceInFiat: type: number format: double nullable: true description: >- Spendable balance converted to fiat, in fiatConversionCurrency. This is the correct field for affordability checks on Crypto accounts — the available field is not populated for Crypto (Crypto). fiatConversionCurrency: type: string nullable: true description: ISO 4217 currency code used for the InFiat values (Crypto). hasOpenPositions: type: boolean nullable: true description: >- Plaee only: true when the user has something open at Plaee - an open prediction-market position or a resting order - and false when nothing is open. Absent when Plaee did not report it. Read this to decide whether to show an "open positions" state; the amounts cannot tell (a position can be worth 0). orderIndex: type: integer format: int32 nullable: true description: Display order index for sorting (Crypto). additionalProperties: false securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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` userKeyAuth: type: apiKey in: header name: x-user-key description: >- 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_` oauth2: type: oauth2 description: >- eToro OAuth2 — send the access token as `Authorization: Bearer `. 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. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both. flows: authorizationCode: authorizationUrl: https://www.etoro.com/sso tokenUrl: https://www.etoro.com/api/sso/v1/token scopes: etoro-public:agent-portfolio:read: Grants access to the 'etoro-public:agent-portfolio:read' scope. etoro-public:agent-portfolio:write: Grants access to the 'etoro-public:agent-portfolio:write' scope. etoro-public:club:read: Grants access to the 'etoro-public:club:read' scope. etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope. etoro-public:demo:write: Grants access to the 'etoro-public:demo:write' scope. etoro-public:feed:read: Grants access to the 'etoro-public:feed:read' scope. etoro-public:feed:write: Grants access to the 'etoro-public:feed:write' scope. etoro-public:market-data:read: Grants access to the 'etoro-public:market-data:read' scope. etoro-public:money.balance:read: Grants access to the 'etoro-public:money.balance:read' scope. etoro-public:money.cash-transactions:read: >- Grants access to the 'etoro-public:money.cash-transactions:read' scope. etoro-public:money.transfer:read: Grants access to the 'etoro-public:money.transfer:read' scope. etoro-public:money.transfer:write: Grants access to the 'etoro-public:money.transfer:write' scope. etoro-public:money:transfer: Grants access to the 'etoro-public:money:transfer' scope. etoro-public:notifications:read: Grants access to the 'etoro-public:notifications:read' scope. etoro-public:notifications:write: Grants access to the 'etoro-public:notifications:write' scope. etoro-public:pi-data:read: Grants access to the 'etoro-public:pi-data:read' scope. etoro-public:price-alerts:read: Grants access to the 'etoro-public:price-alerts:read' scope. etoro-public:price-alerts:write: Grants access to the 'etoro-public:price-alerts:write' scope. etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope. etoro-public:real:write: Grants access to the 'etoro-public:real:write' scope. etoro-public:sso-applications:read: Grants access to the 'etoro-public:sso-applications:read' scope. etoro-public:sso-applications:write: Grants access to the 'etoro-public:sso-applications:write' scope. etoro-public:sso-scopes:read: Grants access to the 'etoro-public:sso-scopes:read' scope. etoro-public:sso-scopes:write: Grants access to the 'etoro-public:sso-scopes:write' scope. etoro-public:sub-accounts:read: Grants access to the 'etoro-public:sub-accounts:read' scope. etoro-public:sub-accounts:write: Grants access to the 'etoro-public:sub-accounts:write' scope. etoro-public:trade.demo:read: Grants access to the 'etoro-public:trade.demo:read' scope. etoro-public:trade.demo:write: Grants access to the 'etoro-public:trade.demo:write' scope. etoro-public:trade.real:read: Grants access to the 'etoro-public:trade.real:read' scope. etoro-public:trade.real:write: Grants access to the 'etoro-public:trade.real:write' scope. etoro-public:user-info:read: Grants access to the 'etoro-public:user-info:read' scope. etoro-public:watchlist:read: Grants access to the 'etoro-public:watchlist:read' scope. etoro-public:watchlist:write: Grants access to the 'etoro-public:watchlist:write' scope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.