Get ranking row for a single investor

curl --request GET \
  --url https://public-api.etoro.com/api/v2/portfolios/{username}/rankings \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>'

import requests

url = "https://public-api.etoro.com/api/v2/portfolios/{username}/rankings"

headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>'
  }
};

fetch('https://public-api.etoro.com/api/v2/portfolios/{username}/rankings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v2/portfolios/{username}/rankings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v2/portfolios/{username}/rankings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v2/portfolios/{username}/rankings")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v2/portfolios/{username}/rankings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "cid": 123,
    "username": "<string>",
    "fullName": "<string>",
    "avatarUrl": "<string>",
    "type": "trader",
    "subType": "pi-cadet",
    "industryTags": [
      "<string>"
    ],
    "sectorTags": [
      "<string>"
    ],
    "gain": 123,
    "dailyGain": 123,
    "thisWeekGain": 123,
    "fiveYearGain": 123,
    "tenYearGain": 123,
    "annualizedReturn": 123,
    "riskScore": 123,
    "maxDailyRiskScore": 123,
    "maxMonthlyRiskScore": 123,
    "copiers": 123,
    "copiedTrades": 123,
    "copyTradesPct": 123,
    "copyInvestmentPct": 123,
    "baseLineCopiers": 123,
    "copiersGain": 123,
    "aumTier": 123,
    "aumTierDesc": "<string>",
    "aumValue": 123,
    "virtualCopiers": 123,
    "dailyDD": 123,
    "weeklyDD": 123,
    "profitableWeeksPct": 123,
    "profitableMonthsPct": 123,
    "peakToValley": 123,
    "peakToValleyStart": "2023-11-07T05:31:56Z",
    "peakToValleyEnd": "2023-11-07T05:31:56Z",
    "trades": 123,
    "winRatio": 123,
    "velocity": 123,
    "exposure": 123,
    "avgPosSize": 123,
    "optimalCopyPosSize": 123,
    "highLeveragePct": 123,
    "mediumLeveragePct": 123,
    "lowLeveragePct": 123,
    "longPosPct": 123,
    "topTradedInstrumentId": 123,
    "topTradedAssetClassId": 123,
    "topTradedInstrumentPct": 123,
    "totalTradedInstruments": 123,
    "activeWeeks": 123,
    "firstActivity": "2023-11-07T05:31:56Z",
    "lastActivity": "2023-11-07T05:31:56Z",
    "activeWeeksPct": 123,
    "weeksSinceRegistration": 123,
    "country": "<string>"
  }
}

{
  "success": true,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>",
    "value": "<string>"
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "requestId": "<string>"
}

{
  "success": true,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>",
    "value": "<string>"
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "requestId": "<string>"
}

{
  "success": true,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>",
    "value": "<string>"
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "requestId": "<string>"
}

Rankings

Get ranking row for a single investor

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 full ranking row for the specified investor for a given time period. Returns 404 if the user is private, not found, or not ranked. period is required because every performance field is computed over a defined time window.

GET

api

portfolios

{username}

rankings

Get ranking row for a single investor

curl --request GET \
  --url https://public-api.etoro.com/api/v2/portfolios/{username}/rankings \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>'

import requests

url = "https://public-api.etoro.com/api/v2/portfolios/{username}/rankings"

headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>'
  }
};

fetch('https://public-api.etoro.com/api/v2/portfolios/{username}/rankings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v2/portfolios/{username}/rankings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v2/portfolios/{username}/rankings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v2/portfolios/{username}/rankings")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v2/portfolios/{username}/rankings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "cid": 123,
    "username": "<string>",
    "fullName": "<string>",
    "avatarUrl": "<string>",
    "type": "trader",
    "subType": "pi-cadet",
    "industryTags": [
      "<string>"
    ],
    "sectorTags": [
      "<string>"
    ],
    "gain": 123,
    "dailyGain": 123,
    "thisWeekGain": 123,
    "fiveYearGain": 123,
    "tenYearGain": 123,
    "annualizedReturn": 123,
    "riskScore": 123,
    "maxDailyRiskScore": 123,
    "maxMonthlyRiskScore": 123,
    "copiers": 123,
    "copiedTrades": 123,
    "copyTradesPct": 123,
    "copyInvestmentPct": 123,
    "baseLineCopiers": 123,
    "copiersGain": 123,
    "aumTier": 123,
    "aumTierDesc": "<string>",
    "aumValue": 123,
    "virtualCopiers": 123,
    "dailyDD": 123,
    "weeklyDD": 123,
    "profitableWeeksPct": 123,
    "profitableMonthsPct": 123,
    "peakToValley": 123,
    "peakToValleyStart": "2023-11-07T05:31:56Z",
    "peakToValleyEnd": "2023-11-07T05:31:56Z",
    "trades": 123,
    "winRatio": 123,
    "velocity": 123,
    "exposure": 123,
    "avgPosSize": 123,
    "optimalCopyPosSize": 123,
    "highLeveragePct": 123,
    "mediumLeveragePct": 123,
    "lowLeveragePct": 123,
    "longPosPct": 123,
    "topTradedInstrumentId": 123,
    "topTradedAssetClassId": 123,
    "topTradedInstrumentPct": 123,
    "totalTradedInstruments": 123,
    "activeWeeks": 123,
    "firstActivity": "2023-11-07T05:31:56Z",
    "lastActivity": "2023-11-07T05:31:56Z",
    "activeWeeksPct": 123,
    "weeksSinceRegistration": 123,
    "country": "<string>"
  }
}

{
  "success": true,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>",
    "value": "<string>"
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "requestId": "<string>"
}

{
  "success": true,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>",
    "value": "<string>"
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "requestId": "<string>"
}

{
  "success": true,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "details": "<string>",
    "field": "<string>",
    "value": "<string>"
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "requestId": "<string>"
}

Authorizations

x-api-key

string

header

default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

required

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

x-user-key

string

header

default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

required

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_

Headers

x-request-id

string<uuid>

required

A unique request identifier.

Example:

"aeb3c639-387b-4a87-88ac-c02195a89395"

Path Parameters

username

string

required

Query Parameters

period

enum<string>

required

Rolling time window for performance metrics. Rolling time window over which all performance metrics are computed. Every window ends at the max date (the latest ranking refresh); examples below use a max date of 2026-07-15:

CurrMonth – current month to date, from the 1st of the current month. E.g. 2026-07-01 to 2026-07-15.
CurrQuarter – current quarter to date, from the 1st day of the current calendar quarter. E.g. 2026-07-01 to 2026-07-15.
CurrYear – year to date, from January 1st of the current year. E.g. 2026-01-01 to 2026-07-15.
LastYear – from January 1st of the previous calendar year to the max date. E.g. 2025-01-01 to 2026-07-15.
LastTwoYears – from January 1st two calendar years ago to the max date. E.g. 2024-01-01 to 2026-07-15.
OneMonthAgo – rolling ~1 month window, from the 1st of the previous month. E.g. 2026-06-01 to 2026-07-15.
TwoMonthsAgo – rolling ~2 month window, from the 1st of the month two months ago. E.g. 2026-05-01 to 2026-07-15.
ThreeMonthsAgo – rolling ~3 month window, from the 1st of the month three months ago. E.g. 2026-04-01 to 2026-07-15.
SixMonthsAgo – rolling ~6 month window, from the 1st of the month six months ago. E.g. 2026-01-01 to 2026-07-15.
OneYearAgo – rolling ~12 month window, from the 1st of the month twelve months ago. E.g. 2025-07-01 to 2026-07-15.
AbsOneYear – exactly one year before the max date, with no rounding to month/year start. E.g. 2025-07-15 to 2026-07-15.
AbsTwoYears – exactly two years before the max date, with no rounding. E.g. 2024-07-15 to 2026-07-15.

Available options:

CurrMonth,

OneMonthAgo,

TwoMonthsAgo,

CurrQuarter,

ThreeMonthsAgo,

SixMonthsAgo,

CurrYear,

OneYearAgo,

LastYear,

LastTwoYears,

AbsOneYear,

AbsTwoYears

Response

Successful response

data

object

A single investor ranking row. Identity fields come from PublicAggregatedInfo (GDPR-safe); performance fields come from RankingsAPI and are period-scoped. Nullable identity fields are omitted from the body when their condition is not met.

Show child attributes

⌘I

Getting started

Guides

Core API

Deprecated

WebSocket API

Vibe Code

AI Agents

Changelog

Get ranking row for a single investor

Authorizations

Headers

Path Parameters

Query Parameters

Response