Create a new watchlist
Rate limit: 20 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:
DELETE /api/v1/watchlists/{watchlistId}DELETE /api/v1/watchlists/{watchlistId}/itemsPOST /api/v1/watchlists/default-watchlist/selected-itemsPOST /api/v1/watchlists/newasdefault-watchlistPOST /api/v1/watchlists/{watchlistId}/itemsPUT /api/v1/watchlists/rank/{watchlistId}PUT /api/v1/watchlists/setUserSelectedUserDefault/{watchlistId}PUT /api/v1/watchlists/{watchlistId}PUT /api/v1/watchlists/{watchlistId}/items
Creates a new watchlist for the authenticated user with the specified name and type.
Authorizations
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
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_
Headers
A unique request identifier.
"f88a717b-bade-45b1-9bab-9fbf0b75259f"
Query Parameters
Name of the new watchlist
100"Tech Watchlist"
Type of watchlist to create
Static, Dynamic "Static"
Dynamic query URL for dynamic watchlists
Response
Watchlist created successfully
Response containing multiple watchlists with metadata