v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB

Watchlists

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}/items
POST /api/v1/watchlists/default-watchlist/selected-items
POST /api/v1/watchlists/newasdefault-watchlist
POST /api/v1/watchlists/{watchlistId}/items
PUT /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.

post/api/v1/watchlists

Query parameters

namestring required

Example:Tech Watchlist

Name of the new watchlist

type'Static' | 'Dynamic'

Example:Static

Type of watchlist to create

dynamicQuerystring

Dynamic query URL for dynamic watchlists

Headers

x-request-idstring uuid required

Example:bbbd1013-7a5d-4726-87a1-0f46d1aa6bce

A unique request identifier.

x-api-keystring password required

Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required

Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Response

Watchlist created successfully

statusinteger

HTTP status code of the response

isSucceededboolean

Whether the request succeeded

Example response

{
  "status": 200,
  "watchlists": [
    {
      "watchlistId": "12345",
      "name": "Tech Watchlist",
      "Gcid": 12345,
      "watchlistType": "Static",
      "totalItems": 100,
      "isDefault": true,
      "isUserSelectedDefault": true,
      "watchlistRank": 1,
      "items": [
        {
          "itemId": 12345,
          "itemType": "Instrument",
          "itemRank": 1
        }
      ],
      "relatedAssets": [
        12345,
        67890
      ]
    }
  ],
  "meta": {
    "itemsPerPage": 100,
    "maxItemsInWatchlistLimit": 1000,
    "maxWatchlistsLimit": 10
  },
  "isSucceeded": true
}