Get trade info for a specific user

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

Get trade info for a specific user

cURL

curl --request GET \
  --url https://public-api.etoro.com/api/v1/user-info/people/{username}/tradeinfo \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'

200

{
  "userName": "<string>",
  "fullName": "<string>",
  "weeksSinceRegistration": 123,
  "countryId": 123,
  "affiliateId": 123,
  "isPopularInvestor": true,
  "isFund": true,
  "hasAvatar": true,
  "gain": 123,
  "dailyGain": 123,
  "thisWeekGain": 123,
  "riskScore": 123,
  "maxDailyRiskScore": 123,
  "maxMonthlyRiskScore": 123,
  "copiers": 123,
  "copiedTrades": 123,
  "copyTradesPct": 123,
  "copyInvestmentPct": 123,
  "baseLineCopiers": 123,
  "copiersGain": 123,
  "aumTier": 123,
  "aumTierDesc": "<string>",
  "fundType": 123,
  "virtualCopiers": 123,
  "trades": 123,
  "topTradedInstrumentId": 123,
  "topTradedAssetId": 123,
  "winRatio": 123,
  "dailyDd": 123,
  "weeklyDd": 123,
  "peakToValley": 123,
  "profitableWeeksPct": 123,
  "profitableMonthsPct": 123,
  "avgPosSize": 123,
  "highLeveragePct": 123,
  "mediumLeveragePct": 123,
  "lowLeveragePct": 123,
  "firstActivity": 123,
  "lastActivity": 123,
  "activeWeeksPct": 123,
  "instrumentPct": 123
}

Headers

x-request-id · string<uuid> · required

A unique request identifier.

Example:

"2709b8c2-2aa9-4daf-aa8b-86f6bcd5a6b5"

x-api-key · string<password> · required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key · string<password> · required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

username · string · required

The username of the user to retrieve the discovery info for.

Query Parameters

period · enum<string> · required

The period filter (e.g., LastTwoYears).

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

Response

200 - application/json

OK

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