Get user watchlists
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/default-watchlists/itemsGET /api/v1/watchlists/public/{userId}GET /api/v1/watchlists/public/{userId}/{watchlistId}GET /api/v1/watchlists/{watchlistId}
Retrieves all watchlists for the authenticated user with optional pagination and built-in watchlist management.
Authorizations
eToro OAuth2. 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. The same scopes back the x-api-key/x-user-key credential pair.
Headers
A unique request identifier.
"bf7f9bdd-6ec8-4ed6-903b-a34995ff4a1c"
API key for authentication.
"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"
User-specific authentication key.
"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"
Query Parameters
Number of items to include per watchlist for pagination
1 <= x <= 1000100
Whether to ensure built-in watchlists are included
true
Whether to include related assets in the response
false
Response
Successfully retrieved user watchlists
Response containing multiple watchlists with metadata