Watchlists
Create live watchlist from tags
This endpoint creates a live watchlist by specifying which tags to monitor:
- When new matching events and markets are created on Polymarket, they will automatically be added to the watchlist if
automaticallyAddMatchingEventsis set to true (default). - When events and markets are closed on Polymarket, they will automatically be removed from the watchlist.
In order to receive alerts when new events and markets are created or existing ones are closed, you can create a New or closed events and markets subscription for the watchlist.
Request Formats
V2 Format (Recommended)
Uses explicit includeTags/excludeTags arrays:
{
"name": "Sports & Esports",
"includeTags": ["sports", "esports"],
"excludeTags": ["politics"],
"matchOperator": "OR",
"automaticallyAddMatchingEvents": true
}
V1 Format (Deprecated - will be removed in future version)
Uses tags array with include boolean:
{
"name": "Sports & Esports",
"tags": [
{"tagSlug": "sports", "include": true},
{"tagSlug": "esports", "include": true}
],
"searchMatchOperator": "OR"
}
POST
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json