etoro-api

# 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