eToro Trading API

eToro Public API — full trading, market data, social, and watchlist integration. Supports SSO, Bearer, and API key auth.

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