# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/etoro/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/etoro/get-instrument-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-instrument-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-top-traders \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trader-chart \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trader-portfolio \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trader-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trader-stats \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trader-trades-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trending-cryptos \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/get-trending-stocks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/etoro/search-instruments \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.