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

# Get user trade info

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

## Request

- Base URL: `https://public-api.etoro.com`
- URL: `https://public-api.etoro.com/api/v1/user-info/people/{username}/tradeinfo`
- 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/tradeinfo/get.ts> (a function with typed inputs; its response is checked against the schema)

**Rate limit:** 60 requests per 60 seconds. This is a **dedicated** limit for this endpoint — it is **not shared** with (pooled across) any other endpoint, so the full rate is available to this endpoint alone.

## Path parameters

- `username` string, required

## Query parameters

- `period` 'CurrMonth' | 'CurrQuarter' | 'CurrYear' | 'LastYear' | 'LastTwoYears' | 'OneMonthAgo' | 'TwoMonthsAgo' | 'ThreeMonthsAgo' | 'SixMonthsAgo' | 'OneYearAgo', required

## Headers

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

## Response `200`

OK

- object
  - `userName` string: The username of the customer
  - `fullName` string: Full name of the customer
  - `weeksSinceRegistration` integer: Number of weeks since registration
  - `countryId` integer: The registered country ID of the user
  - `affiliateId` integer: The affiliate ID of the user
  - `isPopularInvestor` boolean: Is the customer a popular investor
  - `isFund` boolean: Does this customer represent a fund
  - `hasAvatar` boolean: Does the customer have a picture
  - `gain` number, float: The periodic gain of the user
  - `dailyGain` number, float: The user's last day gain
  - `thisWeekGain` number, float: The user's gain from the beginning of the trading week
  - `riskScore` integer: The current risk score of the user
  - `maxDailyRiskScore` integer: The maximum daily risk score of the user in this interval
  - `maxMonthlyRiskScore` integer: The maximum monthly risk score of the user in this interval
  - `copiers` integer: The current number of copiers of this user
  - `copiedTrades` integer: The total number of copied trades in this interval
  - `copyTradesPct` number, float: The percentage of copied trades in this interval of all trades
  - `copyInvestmentPct` number, float: The percentage of invested amounts in copied trades in this interval of all investments
  - `baseLineCopiers` integer: The number of copiers one week ago
  - `copiersGain` number, float: The gain percentage of the number of copiers in a week
  - `aumTier` integer: The total assets under management of the user, in a scale of 0-4, where 4 is the highest tier
  - `aumTierDesc` string: Description of the AUM Tier
  - `fundType` integer: Fund Type
  - `virtualCopiers` integer: The total amount of virtual copiers of this user
  - `trades` integer: The total number of trades in this interval
  - `topTradedInstrumentId` integer: Top Traded Instrument ID in this interval
  - `topTradedAssetId` integer: Top Traded Asset ID in this interval
  - `winRatio` number, float: The winning ratio of all closed trades in this interval
  - `dailyDd` number, float: The maximum daily draw-down of the user in this interval
  - `weeklyDd` number, float: The maximum weekly draw-down of this user in this interval
  - `peakToValley` number, float: The peak to valley draw-down in this interval
  - `profitableWeeksPct` number, float: The percentage of trading weeks which were profitable in this interval
  - `profitableMonthsPct` number, float: The percentage of months which were profitable in this interval
  - `avgPosSize` number, float: Average position size relative to the realized equity on opening the trade
  - `highLeveragePct` number, float: High leverage trades percentage in this interval
  - `mediumLeveragePct` number, float: Medium leverage trades percentage in this interval
  - `lowLeveragePct` number, float: Low leverage trades percentage in this interval
  - `firstActivity` integer: Number of days since the beginning of the interval of a user trading activity
  - `lastActivity` integer: Number of days from the last trading activity till the end of the interval
  - `activeWeeksPct` number, float: The percentage of weeks in the interval which the user had active trades
  - `instrumentPct` number, float: Percentage of investment in the requested instrument ID

## Other responses

- `429`: Too Many Requests — the 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)