Skip to main content
GET
Get aggregated portfolio snapshot

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:

"6db5e44a-32f9-4b83-843f-5ad20d168be6"

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.