# Etoro — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Monitor top eToro traders by accessing their profiles, portfolio holdings, performance statistics, and trading history to inform your investment decisions. Discover trending stocks and cryptocurrencies, search for specific instruments, and view detailed market data and news to stay updated on investment opportunities.

**Category:** Finance & Markets | **Website:** [etoro.com/](https://etoro.com/) | **Docs:** [parse.bot/marketplace/fe11b103-64ed-458f-9f4d-ac39285bff0d/etoro-com-api](https://parse.bot/marketplace/fe11b103-64ed-458f-9f4d-ac39285bff0d/etoro-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_instrument_details

Fetch public market data for a given ticker/symbol including current price, price history ranges, financial data (PE ratio, market cap, EPS, dividend yield), trending instruments, and daily movers in the same category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Ticker symbol (e.g. 'AAPL', 'BTC', 'TSLA'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_instrument_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_instrument_news

Retrieve latest news articles for a specific instrument/symbol. Returns up to 3 recent news articles parsed from the instrument's market page. Each article includes title, URL, source, date, and time.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `symbol` | string | Yes | Ticker symbol in lowercase (e.g. 'aapl', 'btc', 'tsla'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_instrument_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"<string>"}'
```

### get_top_traders

Fetch list of top/popular investors from eToro's CopyTrader rankings. Returns paginated results sorted by the specified field over the given time period. Each trader includes gain, risk score, copiers count, country, and trading activity metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Number of results per page. |
| `period` | string | No | Time period for ranking calculation. |
| `sort` | string | No | Sort field for ranking. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_top_traders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","period":"<string>","sort":"<string>"}'
```

### get_trader_chart

Get historical gain history chart data for a trader, broken down by month and year. Each entry includes start date, gain percentage, and simulation flag.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | eToro username of the trader. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trader_chart \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_trader_portfolio

Get the current portfolio and open positions of a specific trader. Returns aggregated positions by instrument and by type. An empty AggregatedPositions array is valid for traders with no open positions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | eToro username of the trader. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trader_portfolio \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_trader_profile

Get full public profile and basic stats of a specific trader by username. Returns monthly/yearly gain history, about info, similar traders, and other profile components. Requires a valid eToro username.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | eToro username of the trader. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trader_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_trader_stats

Retrieve detailed performance statistics for a specific trader including performance history, portfolio risk breakdown, trading stats with per-asset drill-down, and copier statistics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | eToro username of the trader. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trader_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_trader_trades_history

Retrieve trade statistics summary for a trader over a specified time period, including overall stats (totalTrades, winRatio, avgProfitPct, avgLossPct) and per-asset breakdown.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `period` | string | No | Time period for trade history. |
| `username` | string | Yes | eToro username of the trader. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trader_trades_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"<string>","username":"<string>"}'
```

### get_trending_cryptos

Get trending cryptocurrencies, top daily gainers, and top daily losers on the eToro platform. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trending_cryptos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_trending_stocks

Get trending stocks, top daily gainers, and top daily losers on the eToro platform. No parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/get_trending_stocks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_instruments

Search for instruments (stocks, crypto, ETFs, etc.) by keyword. Returns matching instruments with details including symbol, name, type, exchange, country, ISIN code, sector, industry, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'Bitcoin', 'Tesla', 'Gold'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-etoro-com-api-fe11b103/search_instruments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```