etoro.com APIetoro.com ↗
Access eToro trader profiles, portfolio holdings, performance stats, CopyTrader rankings, trending assets, instrument details, and news via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/ffe0735e-7f42-4080-818c-97545b07e55c/get_top_traders?page=1&sort=-gain&period=LastTwoYears&page_size=20' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch list of top/popular investors from eToro's CopyTrader rankings. Returns paginated results sorted by the specified field over the given time period.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort field. Accepted values: '-gain', '-copierscount'. |
| period | string | Time period for ranking calculation. Accepted values: 'LastTwoYears', 'LastYear'. Other values may return upstream errors. |
| page_size | integer | Number of results per page. |
{
"type": "object",
"fields": {
"Items": "array of trader summary objects with fields such as UserName, Gain, RiskScore, Copiers, Country",
"Status": "string indicating request status",
"TotalRows": "integer total number of matching traders"
},
"sample": {
"data": {
"Items": [
{
"Gain": 11362.96,
"Copiers": 2,
"Country": "Germany",
"FullName": "Alfred Balolong Ceralde",
"UserName": "puds05",
"RiskScore": 5,
"CustomerId": 13262688
}
],
"Status": "OK",
"TotalRows": 32044
},
"status": "success"
}
}About the etoro.com API
This API exposes 11 endpoints covering eToro's trading platform data, from CopyTrader rankings to individual instrument market data. Use get_top_traders to pull paginated leaderboard results sorted by gain or copier count, or call get_trader_portfolio to inspect a trader's open positions broken down by instrument type and stock industry. Response fields include UserName, RiskScore, Copiers, AggregatedPositions, winRatio, and more.
Trader Data
The trader-focused endpoints give structured access to eToro's public investor data. get_top_traders accepts sort values of -gain or -copierscount and a period of LastYear or LastTwoYears, returning an array of trader summaries with fields like UserName, Gain, RiskScore, Copiers, and Country, plus a TotalRows count for pagination. get_trader_profile returns a dataComponentsResponse array covering components such as Stats, About, and SimilarTraders for a given username. get_trader_stats goes deeper, returning Performance, PortfolioRisk, TradingStats, AdditionalStats, and CopiersStats components.
Portfolio and Trade History
get_trader_portfolio returns a trader's live positions as AggregatedPositions objects — each with InstrumentID, Direction, Invested, NetProfit, and Value — plus breakdowns by AggregatedPositionsByStockIndustryID and AggregatedPositionsByInstrumentTypeID. An empty AggregatedPositions array is a valid response for traders with no open positions. get_trader_trades_history accepts a period of oneYearAgo or sixMonthsAgo and returns aggregate stats (totalTrades, winRatio, avgProfitPct, avgLossPct) alongside a per-asset breakdown in the assets array. get_trader_chart provides monthly and yearly gain history with gain percentage and a simulation flag for each data point.
Instrument and Market Data
get_instrument_details takes a ticker symbol such as AAPL or BTC and returns marketData (containing priceData, priceHistory, and financialData), instrumentType, dailyRaisers, dailyFallers, and a trending array of related instruments. get_instrument_news returns up to 3 recent articles per symbol with title, url, source, date, and time fields. get_trending_stocks and get_trending_cryptos each return trending, dailyRaisers, and dailyFallers arrays with instrumentId, displayName, price, and deltaPercent.
Search
search_instruments accepts a keyword query and returns an instruments array with fields including symbol, name, type, exchange, country, isinCode, sector, industry, and images. The total field indicates the full match count. This endpoint covers stocks, crypto, ETFs, and other instrument types available on eToro.
- Build a CopyTrader screening tool that filters top investors by gain percentage and risk score using get_top_traders.
- Track a trader's portfolio allocation across instrument types by parsing AggregatedPositionsByInstrumentTypeID from get_trader_portfolio.
- Compute win/loss ratios across asset classes by pulling per-asset stats from get_trader_trades_history.
- Display a historical gain chart for any eToro trader using monthly and yearly data from get_trader_chart.
- Monitor daily crypto movers by reading dailyRaisers and dailyFallers from get_trending_cryptos.
- Power an instrument search feature with symbol, sector, industry, and ISIN data from search_instruments.
- Aggregate recent market news for a watchlist of tickers by calling get_instrument_news for each symbol.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.