---
title: "Get user performance history"
method: GET
path: "/api/v1/user-info/people/{username}/gain"
tags: ["Users Info"]
---

# Get user performance history

`GET /api/v1/user-info/people/{username}/gain`

## Request

- Base URL: `https://public-api.etoro.com`
- URL: `https://public-api.etoro.com/api/v1/user-info/people/{username}/gain`
- Auth: one of:
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:real:read`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:demo:read`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:real:write`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:demo:write`
  - OAuth 2
    - Authorization code
    - Scopes: `etoro-public:user-info:read`
- TypeScript: <https://skmtc.dev/etoro/apis/etoro-api/docs/api/v1/user-info/people/:username/gain/get.ts> (a function with typed inputs; its response is checked against the schema)

**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 comprehensive historical monthly and yearly performance data including gain percentages, risk-adjusted returns, and detailed trading statistics. This endpoint provides both aggregated and time-series performance metrics.

## Path parameters

- `username` string, required

## Headers

- `x-request-id` string, uuid, required
- `x-api-key` string, password, required
- `x-user-key` string, password, required

## Response `200`

OK

- GetUserGainResponse
  - `monthly` GainEntry[]
    - `timestamp` string, date-time
    - `gain` number
  - `yearly` GainEntry[]
    - `timestamp` string, date-time
    - `gain` number

## Other responses

- `429`: Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded.

---

[API](https://skmtc.dev/etoro/apis/etoro-api.md) - [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/etoro/apis/etoro-api/revisions/69c1fb266c35?raw)