Skip to main content
GET
/
api
/
v1
/
trading
/
info
/
aggregate-portfolio
Get aggregated portfolio snapshot
curl --request GET \
  --url https://public-api.etoro.com/api/v1/trading/info/aggregate-portfolio \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "cid": 4498,
  "timestamp": "2026-05-26T15:24:25.267Z",
  "accountCurrency": "USD",
  "accountTotals": {
    "accountAvailableCash": 4320.84,
    "accountFrozenCash": 0,
    "accountCurrentPnl": -300.35,
    "accountTotalValue": 5154.48,
    "accountTotalUsedMargin": 1133.99,
    "accountBalance": 4320.84
  },
  "instrumentAggregates": [
    {
      "instrumentId": 100000,
      "assetCurrency": "USD",
      "totalMarginAccountCurrency": 849.86,
      "totalFees": 0,
      "totalFeesAcctCcy": 0,
      "totalTaxes": 0,
      "totalTaxesAcctCcy": 0,
      "totalMarginAssetCurrency": 849.86,
      "pnlAssetCurrency": -225.3,
      "accountCurrencyRoePercent": -26.51,
      "netContracts": 0.008076,
      "netUnits": 0.008076,
      "netCurrentExposureAssetCurrency": 624.57,
      "netCurrentExposureAccountCurrency": 624.57,
      "netInitialExposureAccountCurrency": 849.87,
      "accountCurrencyReturn": -225.3,
      "liquidationValueAccountCurrency": 624.56,
      "liquidationValueAssetCurrency": 624.56,
      "avgLeverage": 1,
      "avgOpenRate": 105233.5041183754,
      "netAvgOpenRate": 105233.5041183754,
      "avgConversionRate": 1
    }
  ],
  "mirrors": [
    {
      "mirrorId": 1869651,
      "mirrorAvailableCash": 0.04,
      "mirrorDepositTotal": 290,
      "mirrorWithdrawalTotal": 0,
      "mirrorStopLossPercentage": 5,
      "mirrorStopLoss": 14.5,
      "mirrorClosedPositionsPnl": -0.26,
      "mirrorTotals": {
        "mirrorNetFunding": 290,
        "mirrorPositionsPnl": -75.05,
        "mirrorLiquidationValue": 209.08,
        "mirrorPositionsPnlPercent": -0.35,
        "mirrorMarginPercent": 25.06,
        "mirrorValuePercent": 4.06,
        "mirrorActiveMargin": 284.13
      },
      "instrumentAggregates": []
    }
  ]
}

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:

"79c435b4-7cb1-4386-a3d0-9b038dad9f6f"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Query Parameters

​
conversionMode
enum<string>
default:eToroApp

Determines which conversion to use for non-USD assets when the market is closed. 'Realtime' uses the realtime conversion rate. 'eToroApp' uses the last conversion rate at market close time. Default is 'eToroApp'.

Available options:
eToroApp,
Realtime
​
instrumentIds
integer<int32>[]

Scope the response to a specific list of assets by their eToro instrument ID. When omitted, all held assets are returned. Does not affect account-level totals.

​
mirrorIds
integer<int32>[]

Scope copy-trading data to specific relationships by their mirror ID. A mirrorId of 0 refers to positions held directly (not via copy trading). When omitted, all copy-trading relationships are included.

Response

Successfully retrieved aggregated portfolio data

Complete snapshot of the authenticated user's investment portfolio, organized by asset.

​
cid
integer<int32>

Customer ID.

​
timestamp
string<date-time>

Time at which this portfolio snapshot was calculated.

​
accountCurrency
string

ISO 4217 code of the account's base currency (e.g. 'USD').

​
accountTotals
object

Account-level balance and equity totals.

​
instrumentAggregates
object[]

Positions held directly (not via copy trading), grouped by instrument.

​
mirrors
object[]

Copy-trading relationships the user has active.