eToro Public API 📈

Full eToro Public API integration with trading execution, market data, social feed, and watchlists.

API Docs: https://etoro-6fc30280.mintlify.app/ Base URL: https://public-api.etoro.com/api/v1

Authentication

Three auth modes (priority order):

1. SSO Access Token — Authorization: Bearer <access_token>
2. SSO Auth Token — Authorization: <etoro_user_id>
3. API Keys — x-api-key + x-user-key + x-request-id (UUID)

Endpoints

Portfolio & Account

| Tool | Method | Endpoint | Auth | |------|--------|----------|------| | get_portfolio | GET | /trading/info/portfolio (demo: /trading/info/demo/portfolio) | Personal | | get_trading_history | GET | /trading/info/real/history (demo: /trading/info/demo/history) | Personal |

Trading Execution

All trading endpoints support real/demo mode. Demo adds /demo/ after /execution/.

| Tool | Method | Endpoint | |------|--------|----------| | open_position_by_amount | POST | /trading/execution/market-open-orders/by-amount | | open_position_by_units | POST | /trading/execution/market-open-orders/by-units | | close_position | POST | /trading/execution/market-close-orders/{positionId} | | place_limit_order | POST | /trading/execution/limit-orders | | cancel_limit_order | DELETE | /trading/execution/limit-orders/{orderId} | | cancel_open_order | DELETE | /trading/execution/market-open-orders/{orderId} | | cancel_close_order | DELETE | /trading/execution/market-close-orders/{orderId} |

Market Data (Public)

| Tool | Method | Endpoint | |------|--------|----------| | get_market_data | GET | /market-data/search?internalSymbolFull=AAPL | | get_market_rates | GET | /market-data/rates?instrumentIds=1001,1002 | | get_price_history | GET | /market-data/instruments/{id}/candles?period=OneMonth | | get_trading_info | GET | /trading/info/instrument/{id} | | get_asset_classes | GET | /market-data/instrument-types | | get_exchanges | GET | /market-data/exchanges | | get_instrument_metadata | GET | /market-data/instruments?instrumentIds=1001,1002 | | get_closing_prices | GET | /market-data/closing-prices |

Social

| Tool | Method | Endpoint | |------|--------|----------| | get_instrument_feed | GET | /feeds/instruments/{id}?limit=5 | | get_popular_investors | GET | /copy/popular-investors?limit=10 | | search_users | GET | /users/search?query=... | | get_user_portfolio | GET | /users/{username}/portfolio | | get_user_stats | GET | /users/{username}/stats | | get_user_feed | GET | /feeds/users/{username}?limit=5 | | create_post | POST | /feeds/posts | | create_comment | POST | /feeds/posts/{postId}/comments |

Watchlists

| Tool | Method | Endpoint | |------|--------|----------| | get_watchlists | GET | /watchlists | | get_curated_lists | GET | /watchlists/curated | | create_watchlist | POST | /watchlists | | add_to_watchlist | POST | /watchlists/{watchlistId}/items | | remove_from_watchlist | DELETE | /watchlists/{watchlistId}/items/{instrumentId} |

Key Notes

• Instrument IDs are numeric (not tickers). Resolve via /market-data/search?internalSymbolFull=AAPL
• Trading tools default to mode=real. Only use demo if explicitly requested.
• All trading execution is logged with full request details before sending.
• Rate limit: 100 req/min