# eToro API Docs

## Docs

- [SKILL.md](https://api-portal.etoro.com/ai-agents/etoro-skill.md): Agent Skill for accessing the eToro API
- [Create Agent Portfolio](https://api-portal.etoro.com/api-reference/agent-portfolios/create-agent-portfolio.md): Creates a new agent-portfolio — a dedicated user account that receives its own fixed virtual balance (returned in agentPortfolioVirtualBalance). IMPORTANT: investmentAmountInUsd is the amount deducted from YOUR (the caller's) account balance to copy-trade this agent-portfolio — it is NOT the agent-p…
- [Create User Token](https://api-portal.etoro.com/api-reference/agent-portfolios/create-user-token.md): Creates a new user token for the specified agent-portfolio.
- [Delete Agent Portfolio](https://api-portal.etoro.com/api-reference/agent-portfolios/delete-agent-portfolio.md): Permanently removes a agent-portfolio by revoking all user tokens, stopping the copy mirror, and deleting from storage.
- [Delete User Token](https://api-portal.etoro.com/api-reference/agent-portfolios/delete-user-token.md): Permanently revokes the specified user token from a agent-portfolio.
- [Get Agent Portfolios](https://api-portal.etoro.com/api-reference/agent-portfolios/get-agent-portfolios.md): Retrieves all agent-portfolios belonging to the authenticated user.
- [Update User Token](https://api-portal.etoro.com/api-reference/agent-portfolios/update-user-token.md): Updates the settings of an existing user token for a agent-portfolio. At least one field must be provided.
- [Create a comment on a post](https://api-portal.etoro.com/api-reference/comments/create-a-comment-on-a-post.md): Creates a new comment on a specific discussion post. Comments can include text, mentions, tags, and attachments.
- [Create a new discussion post](https://api-portal.etoro.com/api-reference/feeds/create-a-new-discussion-post.md): Creates a new discussion post in the feed system. This endpoint allows users to create posts that can be associated with instruments, users, or general discussions.
- [Get instrument feed posts](https://api-portal.etoro.com/api-reference/feeds/get-instrument-feed-posts.md): Retrieves feed posts associated with a specific financial instrument. The feed includes discussions, analyses, and other content related to the instrument.
- [Get user feed posts](https://api-portal.etoro.com/api-reference/feeds/get-user-feed-posts.md): Retrieves feed posts associated with a specific user. The feed includes the user's discussions, analyses, and other content they have posted.
- [Get authenticated user identity](https://api-portal.etoro.com/api-reference/identity/get-authenticated-user-identity.md): Returns the identity of the currently authenticated user including their Global Customer ID (GCID), Real account Customer ID, and Demo account Customer ID.
- [Fetch available instrument types (asset classes) such as stocks, ETFs, commodities, etc.](https://api-portal.etoro.com/api-reference/market-data/fetch-available-instrument-types-asset-classes-such-as-stocks-etfs-commodities-etc.md)
- [Get historical candles data for an instrument](https://api-portal.etoro.com/api-reference/market-data/get-historical-candles-data-for-an-instrument.md): Retrieves historical price data in OHLCV (Open, High, Low, Close, Volume) format for a specified instrument. The data is organized into time-based candles of various intervals, from one minute to one week.
- [Get historical closing prices for all instruments](https://api-portal.etoro.com/api-reference/market-data/get-historical-closing-prices-for-all-instruments.md)
- [Gets data on available stocks industries](https://api-portal.etoro.com/api-reference/market-data/gets-data-on-available-stocks-industries.md)
- [Retrieve current market rates and pricing information for specified instruments](https://api-portal.etoro.com/api-reference/market-data/retrieve-current-market-rates-and-pricing-information-for-specified-instruments.md): Provides real-time market data including bid/ask prices, conversion rates, and execution prices for specified financial instruments. Essential for price discovery and trade execution decisions.
- [Retrieves a list of exchanges supported by the platform along with basic descriptive data.](https://api-portal.etoro.com/api-reference/market-data/retrieves-a-list-of-exchanges-supported-by-the-platform-along-with-basic-descriptive-data.md)
- [Retrieves metadata for specified instruments, including display names, exchange IDs, and classification.](https://api-portal.etoro.com/api-reference/market-data/retrieves-metadata-for-specified-instruments-including-display-names-exchange-ids-and-classification.md)
- [Search for Instruments](https://api-portal.etoro.com/api-reference/market-data/search-for-instruments.md): Retrieve a list of instruments based on various search criteria. Each field in the response can be utilized as a filter or projection.
- [Get copiers public info](https://api-portal.etoro.com/api-reference/pi-data/get-copiers-public-info.md)
- [Cancels a pending market order for close for the specified order ID.](https://api-portal.etoro.com/api-reference/trading-demo/cancels-a-pending-market-order-for-close-for-the-specified-order-id.md): This endpoint allows traders to cancel a previously placed market order for close before execution. If the order has already been processed, cancellation will not be possible.
- [Cancels an order before it is executed](https://api-portal.etoro.com/api-reference/trading-demo/cancels-an-order-before-it-is-executed.md): This endpoint allows traders to cancel an order before execution. If the order has already been processed, cancellation will not be possible. This operation is idempotent when the order is already closed or cancelled.
- [Create an order](https://api-portal.etoro.com/api-reference/trading-demo/create-an-order.md): This endpoint allows traders to place an order. Leverage, stop-loss, and take-profit settings can be applied. Order size must use exactly one of amount, units, or contracts. A unique X-Request-Id header (GUID) is required for idempotency. Currently only orders to open a position are supported.
- [Creates a market order to close a position or partially close it by specifying the number of units to deduct.](https://api-portal.etoro.com/api-reference/trading-demo/creates-a-market-order-to-close-a-position-or-partially-close-it-by-specifying-the-number-of-units-to-deduct.md): This endpoint allows traders to close an entire position or a portion of it at the current market rate. If `UnitsToDeduct` is provided, only the specified portion will be closed. If `UnitsToDeduct` is omitted or set to null, the full position will be closed.
- [Get Demo Account PnL and Portfolio Details](https://api-portal.etoro.com/api-reference/trading-demo/get-demo-account-pnl-and-portfolio-details.md): Retrieves the demo account's current portfolio, including credit, open positions, orders, mirrors, and PnL details.
- [Get Order Information and Position Details for Demo Account](https://api-portal.etoro.com/api-reference/trading-demo/get-order-information-and-position-details-for-demo-account.md): Retrieves comprehensive information about a specific order, including the order status, execution details, and all positions that were opened or closed from this order. This endpoint is essential for tracking order execution and identifying which positions were created as a result of a specific orde…
- [Retrieve comprehensive portfolio information including positions, orders, and account status](https://api-portal.etoro.com/api-reference/trading-demo/retrieve-comprehensive-portfolio-information-including-positions-orders-and-account-status.md): Returns detailed portfolio information including active positions, pending orders, mirror trading details, and account balances. This endpoint provides a complete overview of the user's trading activity and current market exposure.
- [Cancels a pending market order for close for the specified order ID.](https://api-portal.etoro.com/api-reference/trading-real/cancels-a-pending-market-order-for-close-for-the-specified-order-id.md): This endpoint allows traders to cancel a previously placed market order for close before execution. If the order has already been processed, cancellation will not be possible.
- [Cancels an order before it is executed](https://api-portal.etoro.com/api-reference/trading-real/cancels-an-order-before-it-is-executed.md): This endpoint allows traders to cancel an order before execution. If the order has already been processed, cancellation will not be possible. This operation is idempotent when the order is already closed or cancelled.
- [Create an order](https://api-portal.etoro.com/api-reference/trading-real/create-an-order.md): This endpoint allows traders to place an order. Leverage, stop-loss, and take-profit settings can be applied. Order size must use exactly one of amount, units, or contracts. A unique X-Request-Id header (GUID) is required for idempotency. Currently only orders to open a position are supported.
- [Creates a market order to close a position or partially close it by specifying the number of units to deduct.](https://api-portal.etoro.com/api-reference/trading-real/creates-a-market-order-to-close-a-position-or-partially-close-it-by-specifying-the-number-of-units-to-deduct.md): This endpoint allows traders to close an entire position or a portion of it at the current market rate. If `UnitsToDeduct` is provided, only the specified portion will be closed. If `UnitsToDeduct` is omitted or set to null, the full position will be closed.
- [Get Order Information and Position Details for Real Account](https://api-portal.etoro.com/api-reference/trading-real/get-order-information-and-position-details-for-real-account.md): Retrieves comprehensive information about a specific order, including the order status, execution details, and all positions that were opened or closed from this order. This endpoint is essential for tracking order execution and identifying which positions were created as a result of a specific orde…
- [Get Real Account PnL and Portfolio Details](https://api-portal.etoro.com/api-reference/trading-real/get-real-account-pnl-and-portfolio-details.md): Retrieves the real account's current portfolio, including credit, open positions, orders, mirrors, and PnL details.
- [List trading history](https://api-portal.etoro.com/api-reference/trading-real/list-trading-history.md)
- [Retrieve comprehensive portfolio information including positions, orders, and account status](https://api-portal.etoro.com/api-reference/trading-real/retrieve-comprehensive-portfolio-information-including-positions-orders-and-account-status.md): Returns detailed portfolio information including active positions, pending orders, mirror trading details, and account balances. This endpoint provides a complete overview of the user's trading activity and current market exposure.
- [Comprehensive search and analytics engine for user discovery and analysis](https://api-portal.etoro.com/api-reference/users-info/comprehensive-search-and-analytics-engine-for-user-discovery-and-analysis.md): Powerful search platform that enables advanced user discovery with comprehensive filtering capabilities. Supports complex queries across multiple dimensions including performance metrics, risk profiles, investment patterns, and account characteristics. Ideal for identifying users based on specific t…
- [Get the live portfolio of a user](https://api-portal.etoro.com/api-reference/users-info/get-the-live-portfolio-of-a-user.md)
- [Get trade info for a specific user](https://api-portal.etoro.com/api-reference/users-info/get-trade-info-for-a-specific-user.md)
- [Retrieve comprehensive user profile data and aggregated account information](https://api-portal.etoro.com/api-reference/users-info/retrieve-comprehensive-user-profile-data-and-aggregated-account-information.md): Returns detailed user profile information including account status, verification levels, biographical data, and associated metadata. This endpoint aggregates essential user information from multiple sources to provide a complete user profile overview.
- [Retrieve detailed historical performance metrics and analytics for a specified user](https://api-portal.etoro.com/api-reference/users-info/retrieve-detailed-historical-performance-metrics-and-analytics-for-a-specified-user.md): Returns comprehensive historical monthly and yearly performance data including gain percentages, risk-adjusted returns, and detailed trading statistics. This endpoint provides both aggregated and time-series performance metrics.
- [Retrieve granular performance data for specific time periods](https://api-portal.etoro.com/api-reference/users-info/retrieve-granular-performance-data-for-specific-time-periods.md): Provides detailed performance analytics including daily gains, cumulative returns, and period-specific metrics within a specified date range. Supports various time-based analyses and performance reporting requirements.
- [Add items to watchlist](https://api-portal.etoro.com/api-reference/watchlists/add-items-to-watchlist.md): Adds new items to an existing watchlist.
- [Change watchlist rank](https://api-portal.etoro.com/api-reference/watchlists/change-watchlist-rank.md): Updates the display rank of a watchlist.
- [Create a new watchlist](https://api-portal.etoro.com/api-reference/watchlists/create-a-new-watchlist.md): Creates a new watchlist for the authenticated user with the specified name and type.
- [Create default watchlist with selected items](https://api-portal.etoro.com/api-reference/watchlists/create-default-watchlist-with-selected-items.md): Creates a default watchlist populated with the specified items.
- [Create watchlist and set as default](https://api-portal.etoro.com/api-reference/watchlists/create-watchlist-and-set-as-default.md): Creates a new watchlist and immediately sets it as the user's default watchlist.
- [Delete watchlist](https://api-portal.etoro.com/api-reference/watchlists/delete-watchlist.md): Removes a watchlist and all its items.
- [Get curated lists](https://api-portal.etoro.com/api-reference/watchlists/get-curated-lists.md): Retrieves curated investment lists available to the authenticated user.
- [Get default watchlist items](https://api-portal.etoro.com/api-reference/watchlists/get-default-watchlist-items.md): Retrieves items from user's default watchlists with optional pagination.
- [Get market recommendations](https://api-portal.etoro.com/api-reference/watchlists/get-market-recommendations.md): Retrieves personalized market recommendations for the authenticated user.
- [Get single public watchlist](https://api-portal.etoro.com/api-reference/watchlists/get-single-public-watchlist.md): Retrieves a specific public watchlist from a user.
- [Get single watchlist](https://api-portal.etoro.com/api-reference/watchlists/get-single-watchlist.md): Retrieves a specific watchlist with its items using pagination.
- [Get user watchlists](https://api-portal.etoro.com/api-reference/watchlists/get-user-watchlists.md): Retrieves all watchlists for the authenticated user with optional pagination and built-in watchlist management.
- [Get user's public watchlists](https://api-portal.etoro.com/api-reference/watchlists/get-users-public-watchlists.md): Retrieves all public watchlists for a specific user.
- [Remove items from watchlist](https://api-portal.etoro.com/api-reference/watchlists/remove-items-from-watchlist.md): Removes specified items from a watchlist.
- [Rename watchlist](https://api-portal.etoro.com/api-reference/watchlists/rename-watchlist.md): Updates the name of an existing watchlist.
- [Set a specific watchlist as user's default](https://api-portal.etoro.com/api-reference/watchlists/set-a-specific-watchlist-as-users-default.md): Sets the specified watchlist as the user's default watchlist.
- [Update items in watchlist](https://api-portal.etoro.com/api-reference/watchlists/update-items-in-watchlist.md): Updates existing items in a watchlist (rank, etc.).
- [Authentication](https://api-portal.etoro.com/api-reference/websocket/authentication.md): Authentication of the eToro WebSocket API
- [Example code](https://api-portal.etoro.com/api-reference/websocket/example-code.md): Example code for the eToro WebSocket API
- [Overview](https://api-portal.etoro.com/api-reference/websocket/overview.md): Overview of the eToro WebSocket API
- [Topics](https://api-portal.etoro.com/api-reference/websocket/topics.md): Topics for the eToro WebSocket API
- [Authentication](https://api-portal.etoro.com/getting-started/authentication.md): How to authenticate to the eToro API
- [Rate Limits](https://api-portal.etoro.com/getting-started/rate-limits.md): Understand the rate limits applied to the eToro Public API to ensure smooth and reliable integration.
- [Calculate Available Cash](https://api-portal.etoro.com/guides/calculate-available-cash.md): Learn how to calculate your available cash balance in demo or real accounts.
- [Calculate Equity](https://api-portal.etoro.com/guides/calculate-equity.md): Learn how to calculate your equity in demo or real accounts.
- [Calculate Profit/Loss](https://api-portal.etoro.com/guides/calculate-profit-loss.md): Learn how to calculate your profit/loss (unrealized PnL) in demo or real accounts.
- [Calculate Total Invested](https://api-portal.etoro.com/guides/calculate-total-invested.md): Learn how to calculate your total invested amount in demo or real accounts.
- [Find Instrument ID](https://api-portal.etoro.com/guides/get-instrument-id.md): Learn how to resolve a ticker symbol to an eToro Instrument ID.
- [Open and close market orders](https://api-portal.etoro.com/guides/market-orders.md): Learn how to programmatically execute trades to enter and exit positions using the eToro API.
- [Manage your Watchlists](https://api-portal.etoro.com/guides/watchlists.md): Learn how to create custom watchlists, populate them with assets, and sync your preferences across the eToro ecosystem.
- [Introduction](https://api-portal.etoro.com/index.md): Welcome to the eToro Developer Portal
- [Antigravity](https://api-portal.etoro.com/vibe-code/antigravity.md): Integrate eToro API documentation into Antigravity IDE
- [Base44](https://api-portal.etoro.com/vibe-code/base44.md): Create custom eToro apps using Base44's no-code platform
- [Claude Code](https://api-portal.etoro.com/vibe-code/claude-code.md): Integrate eToro API documentation into Claude Code using MCP
- [Cursor](https://api-portal.etoro.com/vibe-code/cursor.md): Integrate eToro API documentation into Cursor using MCP
- [Windsurf](https://api-portal.etoro.com/vibe-code/windsurf.md): Integrate eToro API documentation into Windsurf IDE

## OpenAPI Specs

- [openapi](https://api-portal.etoro.com/api-reference/openapi.json)