> ## Documentation Index > Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt > Use this file to discover all available pages before exploring further. # Get single public watchlist > **Rate limit:** 60 requests per 60 seconds. This is a **shared quota** — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota: - `GET /api/v1/watchlists` - `GET /api/v1/watchlists/default-watchlists/items` - `GET /api/v1/watchlists/public/{userId}` - `GET /api/v1/watchlists/{watchlistId}` --- Retrieves a specific public watchlist from a user. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/watchlists/public/{userId}/{watchlistId} openapi: 3.0.1 info: title: eToro Api version: v1.387.0 description: >- eToro’s public API provides access to real-time financial data, trading insights, and account management features, allowing developers to integrate eToro’s services into their applications. With access to market prices, historical data, and social trading information, the API empowers users to enhance their trading strategies. Designed for security and scalability, the eToro API ensures smooth and reliable integration for a variety of financial applications. For more details on integrating with eToro's public WebSocket service, please refer to the dedicated [WebSocket documentation](./websocket/websocket-doc.html). ## Authentication Every request must be authenticated with exactly one of two options: an OAuth 2.0 access token (`Authorization: Bearer `), or the non-interactive credential pair (`x-api-key` + `x-user-key` headers). The two options are mutually exclusive — a request carrying both is rejected. Each operation lists the OAuth scopes that grant access as alternative security requirements: a bearer token needs only ONE of them, and the same permissions govern the credential pair. servers: - url: https://public-api.etoro.com description: eToro Public API security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: [] tags: - name: Agent Portfolios - name: Social Feeds - name: Balances - name: Clubs - name: Watchlists - name: Data - name: Top Assets - name: App Data - name: Market Data - name: Identity - name: Cash Accounts - name: Transfer - name: Notifications - name: PI Data - name: PortfolioSearch - name: Price Alerts - name: SSO - Applications - name: SSO - Scopes - name: Sub-Accounts - eToro Trading - name: Sub-Accounts - name: Trading - Demo - name: Trading - Real - name: Users Info - name: Rankings - name: User Stats - name: Copy Trading - name: Copy Trading - Demo paths: /api/v1/watchlists/public/{userId}/{watchlistId}: get: tags: - Watchlists summary: Get single public watchlist description: >- **Rate limit:** 60 requests per 60 seconds. This is a **shared quota** — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota: - `GET /api/v1/watchlists` - `GET /api/v1/watchlists/default-watchlists/items` - `GET /api/v1/watchlists/public/{userId}` - `GET /api/v1/watchlists/{watchlistId}` --- Retrieves a specific public watchlist from a user. operationId: getWatchlistsPublicByUserIdByWatchlistId parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: 68728d1f-2caf-410f-a5ce-3cff599e24df description: A unique request identifier. example: 68728d1f-2caf-410f-a5ce-3cff599e24df - name: userId in: path description: User ID who owns the watchlist required: true schema: type: integer format: int32 example: 12345 - name: watchlistId in: path description: Unique identifier of the watchlist required: true schema: type: string example: '12345' - name: pageNumber in: query description: Page number for pagination schema: type: integer format: int32 default: 0 example: 0 - name: itemsPerPage in: query description: Number of items per page schema: type: integer format: int32 default: 100 example: 30 responses: '200': description: Successfully retrieved public watchlist content: application/json: schema: $ref: '#/components/schemas/WatchlistResponse' headers: RateLimit-Limit: description: >- Maximum number of requests allowed per window. This budget is SHARED across 5 endpoints (it is NOT per-endpoint): a request to any endpoint in the group spends the same budget. See this operation's description for the full list of endpoints sharing it. schema: type: integer example: 60 RateLimit-Remaining: description: Requests remaining in the current window for this quota. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer RateLimit-Policy: description: Quota policy in the form `;w=`. schema: type: string example: 60;w=60 '429': description: >- Too Many Requests — the shared rate limit (60 requests / 60s) was exceeded. headers: RateLimit-Limit: description: >- Maximum number of requests allowed per window. This budget is SHARED across 5 endpoints (it is NOT per-endpoint): a request to any endpoint in the group spends the same budget. See this operation's description for the full list of endpoints sharing it. schema: type: integer example: 60 RateLimit-Remaining: description: Requests remaining in the current window for this quota. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer RateLimit-Policy: description: Quota policy in the form `;w=`. schema: type: string example: 60;w=60 Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 60 security: - apiKeyAuth: [] userKeyAuth: [] - oauth2: - etoro-public:demo:read - oauth2: - etoro-public:real:read - oauth2: - etoro-public:demo:write - oauth2: - etoro-public:real:write - oauth2: - etoro-public:watchlist:read - oauth2: - etoro-public:watchlist:write components: schemas: WatchlistResponse: type: object description: Represents a watchlist with its metadata and items properties: watchlistId: type: string description: Unique identifier of the watchlist example: '12345' name: type: string description: Display name of the watchlist example: Tech Watchlist Gcid: type: integer format: int32 description: Global Customer ID of the watchlist owner example: 12345 watchlistType: type: string enum: - Static - Dynamic - RecentlyInvested - Default description: Type of the watchlist example: Static totalItems: type: integer format: int32 description: Total number of items in the watchlist example: 100 isDefault: type: boolean description: Whether this is a default system watchlist example: true isUserSelectedDefault: type: boolean description: Whether this is the user's selected default watchlist example: true watchlistRank: type: integer format: int32 description: Display order rank of the watchlist example: 1 dynamicUrl: type: string nullable: true description: URL for dynamic watchlist queries items: type: array description: Items contained in the watchlist items: $ref: '#/components/schemas/WatchlistItemDto' example: - itemId: 12345 itemType: Instrument itemRank: 1 relatedAssets: type: array description: Related asset IDs nullable: true items: type: integer format: int32 example: - 12345 - 67890 WatchlistItemDto: type: object description: Represents an item in a watchlist required: - itemId - itemType properties: itemId: type: integer format: int32 description: Unique identifier of the financial instrument example: 12345 itemType: type: string description: Type of the financial instrument (e.g., 'Instrument', 'Person') example: Instrument itemRank: type: integer format: int32 description: Ranking position of the item in the watchlist default: 0 example: 1 itemAddedReason: type: string description: Reason the item was added to the watchlist example: Manual itemAddedDate: type: string format: date-time description: Date and time the item was added market: type: object description: Market metadata for the instrument when included properties: id: type: string symbolName: type: string displayName: type: string assetTypeId: type: integer format: int32 assetTypeSubCategoryId: type: integer format: int32 nullable: true exchangeId: type: integer format: int32 hasExpirationDate: type: boolean avatar: type: object properties: small: type: string medium: type: string large: type: string svg: type: object nullable: true description: SVG avatar with background and text colors properties: url: type: string backgroundColor: type: string textColor: type: string securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe. Demo credential for trying the API from these docs: `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663` userKeyAuth: type: apiKey in: header name: x-user-key description: >- User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. Demo credential for trying the API from these docs: `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_` oauth2: type: oauth2 description: >- eToro OAuth2 — send the access token as `Authorization: Bearer `. Each operation lists the scopes that grant access as separate `security` requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. Mutually exclusive with the x-api-key/x-user-key credential pair: never send both. flows: authorizationCode: authorizationUrl: https://www.etoro.com/sso tokenUrl: https://www.etoro.com/api/sso/v1/token scopes: etoro-public:agent-portfolio:read: Grants access to the 'etoro-public:agent-portfolio:read' scope. etoro-public:agent-portfolio:write: Grants access to the 'etoro-public:agent-portfolio:write' scope. etoro-public:club:read: Grants access to the 'etoro-public:club:read' scope. etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope. etoro-public:demo:write: Grants access to the 'etoro-public:demo:write' scope. etoro-public:feed:read: Grants access to the 'etoro-public:feed:read' scope. etoro-public:feed:write: Grants access to the 'etoro-public:feed:write' scope. etoro-public:market-data:read: Grants access to the 'etoro-public:market-data:read' scope. etoro-public:money.balance:read: Grants access to the 'etoro-public:money.balance:read' scope. etoro-public:money.cash-transactions:read: >- Grants access to the 'etoro-public:money.cash-transactions:read' scope. etoro-public:money.transfer:read: Grants access to the 'etoro-public:money.transfer:read' scope. etoro-public:money.transfer:write: Grants access to the 'etoro-public:money.transfer:write' scope. etoro-public:money:transfer: Grants access to the 'etoro-public:money:transfer' scope. etoro-public:notifications:read: Grants access to the 'etoro-public:notifications:read' scope. etoro-public:notifications:write: Grants access to the 'etoro-public:notifications:write' scope. etoro-public:pi-data:read: Grants access to the 'etoro-public:pi-data:read' scope. etoro-public:price-alerts:read: Grants access to the 'etoro-public:price-alerts:read' scope. etoro-public:price-alerts:write: Grants access to the 'etoro-public:price-alerts:write' scope. etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope. etoro-public:real:write: Grants access to the 'etoro-public:real:write' scope. etoro-public:sso-applications:read: Grants access to the 'etoro-public:sso-applications:read' scope. etoro-public:sso-applications:write: Grants access to the 'etoro-public:sso-applications:write' scope. etoro-public:sso-scopes:read: Grants access to the 'etoro-public:sso-scopes:read' scope. etoro-public:sso-scopes:write: Grants access to the 'etoro-public:sso-scopes:write' scope. etoro-public:sub-accounts:read: Grants access to the 'etoro-public:sub-accounts:read' scope. etoro-public:sub-accounts:write: Grants access to the 'etoro-public:sub-accounts:write' scope. etoro-public:trade.demo:read: Grants access to the 'etoro-public:trade.demo:read' scope. etoro-public:trade.demo:write: Grants access to the 'etoro-public:trade.demo:write' scope. etoro-public:trade.real:read: Grants access to the 'etoro-public:trade.real:read' scope. etoro-public:trade.real:write: Grants access to the 'etoro-public:trade.real:write' scope. etoro-public:user-info:read: Grants access to the 'etoro-public:user-info:read' scope. etoro-public:watchlist:read: Grants access to the 'etoro-public:watchlist:read' scope. etoro-public:watchlist:write: Grants access to the 'etoro-public:watchlist:write' scope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.