Skip to main content
GET
Get paginated investor rankings

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:

"1a783925-8963-4936-8b5c-133bd5de4fe6"

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

period
enum<string>
required

Rolling time window for performance metrics.

Available options:
CurrMonth,
OneMonthAgo,
TwoMonthsAgo,
CurrQuarter,
ThreeMonthsAgo,
SixMonthsAgo,
CurrYear,
OneYearAgo,
LastYear,
LastTwoYears
sort
string

Sort field in camelCase; prefix with - for descending (e.g. -copiers). Unknown values are rejected with 400.

Example:

"-copiers"

page
integer
default:1
Required range: x >= 1
pageSize
integer
default:20
Required range: 1 <= x <= 100
country
string

Filter by ISO 3166-1 alpha-2 country code (e.g. "GB", "US").

gainMin
number
gainMax
number
copiersMin
integer
copiersMax
integer
riskScoreMin
integer
Required range: 1 <= x <= 10
riskScoreMax
integer
Required range: 1 <= x <= 10

When true, filters to active Popular Investors only.

aumTier
integer

Response

Successful response

results
object[]
required
pagination
object
required