This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist.
When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the Webhooks documentation for more details on the webhook payloads.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Nevua Markets","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/nevuamarkets/W0J7GLoXCapcPT02/logo/nevua-markets-logo-400-150.svg?fit=max\u0026auto=format\u0026n=W0J7GLoXCapcPT02\u0026q=85\u0026s=682f654a0483aa90541cece85e4566d3","dark":"https://mintcdn.com/nevuamarkets/W0J7GLoXCapcPT02/logo/nevua-markets-logo-400-150-dark.svg?fit=max\u0026auto=format\u0026n=W0J7GLoXCapcPT02\u0026q=85\u0026s=dbf397e174002b44c18b2c2053fbd3c4"},"api":{"openapi":"openapi.json"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Nevua Markets","icon":"house","href":"https://nevua.markets"},{"anchor":"Twitter","icon":"twitter","href":"https://x.com/NevuaMarkets"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nevuamarkets","hasAudioNarration":false,"actualSubdomain":"nevuamarkets","customDomains":["docs.nevua.markets"],"gitSource":{"type":"github","owner":"nevuamarkets","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e70acf44a63d52c979d5","collectionId":"7de2d100-328a-4a4e-a306-4b33ddbd1d29","schemaVersion":"v2"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae92919fdb35cf962a96185:success","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Developer API","count":18},{"language":"default","tag":"API Documentation","count":18},{"language":"default","tag":"Alerts","count":13},{"language":"default","tag":"User Guide","count":12},{"language":"default","tag":"Demo","count":7},{"language":"default","tag":"Watchlists","count":5},{"language":"default","tag":"Notification Channels","count":4},{"language":"default","tag":"Introduction","count":3},{"language":"default","tag":"Search","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/alerts/create-a-watchlist-subscription","slug":"/api-reference/alerts/create-a-watchlist-subscription","pageMetadata":{"title":"Create a watchlist subscription","description":"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist.\n\nWhen the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the [Webhooks](https://docs.nevua.markets//api-reference/alert-webhooks/webhook-payloads) documentation for more details on the webhook payloads.\n","deprecated":null,"version":null,"openapi":"openapi.json post /subscriptions/{watchlistId}","href":"/api-reference/alerts/create-a-watchlist-subscription","autogeneratedByOpenApi":true,"hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the \", _jsx(_components.a, {\n href: \"https://docs.nevua.markets//api-reference/alert-webhooks/webhook-payloads\",\n children: \"Webhooks\"\n }), \" documentation for more details on the webhook payloads.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a watchlist subscription","description":"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist.\n\nWhen the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the [Webhooks](https://docs.nevua.markets//api-reference/alert-webhooks/webhook-payloads) documentation for more details on the webhook payloads.\n","deprecated":null,"version":null,"openapi":"openapi.json post /subscriptions/{watchlistId}","href":"/api-reference/alerts/create-a-watchlist-subscription","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createWatchlistSubscription","security":["e7bacb44-ab52-4ee8-9451-140496d97f04"],"summary":"Create a watchlist subscription","description":"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist.\n\nWhen the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the [Webhooks](https://docs.nevua.markets//api-reference/alert-webhooks/webhook-payloads) documentation for more details on the webhook payloads.\n","tags":["Alerts"],"parameters":["0322a1bf-c63d-4804-986e-d7f52d9b39bf"],"requestBody":"ff60c0fb-39d8-4717-99dd-6a593f6e0ce7","responses":{"200":"6a431a00-7ac3-4426-b1d7-2edaf2f393e0","400":"9dbf79f9-f5d3-486a-b0ed-bec106933966","401":"54636f43-1e9a-40f9-8b77-74223938870b","404":"e9539062-c106-4a9f-93ff-853fe27f4d53","429":"5f8205a3-827e-4158-9d65-8c49d10c723a","500":"232bcc34-63eb-4716-9cc4-d9d7097285cd"},"method":"post","type":"path","servers":["6e4cdcdd-936a-4ec3-8376-119d368e8477"],"path":"/subscriptions/{watchlistId}","baseUrlOptions":["https://api.nevua.markets"],"title":"Create a watchlist subscription","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0322a1bf-c63d-4804-986e-d7f52d9b39bf":{"name":"watchlistId","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The ID of the watchlist to create a subscription for","uniqueKey":"","typeLabel":"string"},"description":"The ID of the watchlist to create a subscription for"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["Watchlist"],"description":"The scope of the subscription. Currently only `Watchlist` is supported.","isRequired":true,"uniqueKey":"scope","typeLabel":"enum\u003cstring>"},"rule":{"oneOf":[{"type":"object","title":"Event and Market Status Changes","description":"A 'New or closed events and markets' rule will fire an alert when new events and markets are created or when existing ones close.\n\nThis rule is always **Recurring** and will fire as soon as a market/event status change is detected.","required":["type"],"properties":{"type":{"type":"string","enum":["New or closed events and markets"],"isRequired":true,"uniqueKey":"rule.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.0","typeLabel":"Event and Market Status Changes · object"},{"type":"object","title":"Crossing","description":"A 'Crossing' rule will fire an alert if the price crosses the specified threshold in either direction (up or down).","required":["params","type"],"properties":{"type":{"type":"string","enum":["Crossing"],"isRequired":true,"uniqueKey":"rule.oneOf.1.type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","properties":{"thresholdPercent":{"type":"number","isRequired":true,"uniqueKey":"rule.oneOf.1.params.thresholdPercent","typeLabel":"number"},"triggerType":{"type":"string","enum":["One Time","Recurring"],"description":"Controls if the rule will fire once or repeatedly.","isRequired":true,"uniqueKey":"rule.oneOf.1.params.triggerType","typeLabel":"enum\u003cstring>"},"triggerInterval":{"enum":["0m","12h","24h","30m","5m","60m","6h"],"type":"string","description":"Controls how often the rule will fire since the last trigger.\n\n- For `One Time` rules, this is ignored.\n- For `Recurring` rules, default is 30 minutes.","uniqueKey":"rule.oneOf.1.params.triggerInterval","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["thresholdPercent","triggerType"],"isRequired":true,"uniqueKey":"rule.oneOf.1.params","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.1","typeLabel":"Crossing · object"},{"type":"object","title":"Crossing Up","description":"A 'Crossing Up' rule will fire an alert if the price crosses the specified threshold upward.","required":["params","type"],"properties":{"type":{"type":"string","enum":["Crossing Up"],"isRequired":true,"uniqueKey":"rule.oneOf.2.type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","properties":{"thresholdPercent":{"type":"number","isRequired":true,"uniqueKey":"rule.oneOf.2.params.thresholdPercent","typeLabel":"number"},"triggerType":{"type":"string","enum":["One Time","Recurring"],"description":"Controls if the rule will fire once or repeatedly.","isRequired":true,"uniqueKey":"rule.oneOf.2.params.triggerType","typeLabel":"enum\u003cstring>"},"triggerInterval":{"enum":["0m","12h","24h","30m","5m","60m","6h"],"type":"string","description":"Controls how often the rule will fire since the last trigger.\n\n- For `One Time` rules, this is ignored.\n- For `Recurring` rules, default is 30 minutes.","uniqueKey":"rule.oneOf.2.params.triggerInterval","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["thresholdPercent","triggerType"],"isRequired":true,"uniqueKey":"rule.oneOf.2.params","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.2","typeLabel":"Crossing Up · object"},{"type":"object","title":"Crossing Down","description":"A 'Crossing Down' rule will fire an alert if the price crosses the specified threshold downward.","required":["params","type"],"properties":{"type":{"type":"string","enum":["Crossing Down"],"isRequired":true,"uniqueKey":"rule.oneOf.3.type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","properties":{"thresholdPercent":{"type":"number","isRequired":true,"uniqueKey":"rule.oneOf.3.params.thresholdPercent","typeLabel":"number"},"triggerType":{"type":"string","enum":["One Time","Recurring"],"description":"Controls if the rule will fire once or repeatedly.","isRequired":true,"uniqueKey":"rule.oneOf.3.params.triggerType","typeLabel":"enum\u003cstring>"},"triggerInterval":{"enum":["0m","12h","24h","30m","5m","60m","6h"],"type":"string","description":"Controls how often the rule will fire since the last trigger.\n\n- For `One Time` rules, this is ignored.\n- For `Recurring` rules, default is 30 minutes.","uniqueKey":"rule.oneOf.3.params.triggerInterval","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["thresholdPercent","triggerType"],"isRequired":true,"uniqueKey":"rule.oneOf.3.params","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.3","typeLabel":"Crossing Down · object"},{"type":"object","title":"Crossing Step","description":"A 'Crossing Step' rule will fire an alert whenever the price crosses set step thresholds. For instance, with a 10% step, you'll get alerts at 10%, 20%, 30%, 40%, and so on, for both up and down movements.","required":["params","type"],"properties":{"type":{"type":"string","enum":["Crossing Step"],"isRequired":true,"uniqueKey":"rule.oneOf.4.type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","properties":{"thresholdPercent":{"type":"number","isRequired":true,"uniqueKey":"rule.oneOf.4.params.thresholdPercent","typeLabel":"number"},"triggerType":{"type":"string","enum":["One Time","Recurring"],"description":"Controls if the rule will fire once or repeatedly.","isRequired":true,"uniqueKey":"rule.oneOf.4.params.triggerType","typeLabel":"enum\u003cstring>"},"triggerInterval":{"enum":["0m","12h","24h","30m","5m","60m","6h"],"type":"string","description":"Controls how often the rule will fire since the last trigger.\n\n- For `One Time` rules, this is ignored.\n- For `Recurring` rules, default is 30 minutes.","uniqueKey":"rule.oneOf.4.params.triggerInterval","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["thresholdPercent","triggerType"],"isRequired":true,"uniqueKey":"rule.oneOf.4.params","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.4","typeLabel":"Crossing Step · object"},{"type":"object","title":"Greater Than","description":"A 'Greater Than' rule will fire an alert if the price is greater than the specified threshold.","required":["params","type"],"properties":{"type":{"type":"string","enum":["Greater Than"],"isRequired":true,"uniqueKey":"rule.oneOf.5.type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","properties":{"thresholdPercent":{"type":"number","isRequired":true,"uniqueKey":"rule.oneOf.5.params.thresholdPercent","typeLabel":"number"},"triggerType":{"type":"string","enum":["One Time","Recurring"],"description":"Controls if the rule will fire once or repeatedly.","isRequired":true,"uniqueKey":"rule.oneOf.5.params.triggerType","typeLabel":"enum\u003cstring>"},"triggerInterval":{"enum":["0m","12h","24h","30m","5m","60m","6h"],"type":"string","description":"Controls how often the rule will fire since the last trigger.\n\n- For `One Time` rules, this is ignored.\n- For `Recurring` rules, default is 30 minutes.","uniqueKey":"rule.oneOf.5.params.triggerInterval","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["thresholdPercent","triggerType"],"isRequired":true,"uniqueKey":"rule.oneOf.5.params","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.5","typeLabel":"Greater Than · object"},{"type":"object","title":"Less Than","description":"A 'Less Than' rule will fire an alert if the price is less than the specified threshold.","required":["params","type"],"properties":{"type":{"type":"string","enum":["Less Than"],"isRequired":true,"uniqueKey":"rule.oneOf.6.type","typeLabel":"enum\u003cstring>"},"params":{"type":"object","properties":{"thresholdPercent":{"type":"number","isRequired":true,"uniqueKey":"rule.oneOf.6.params.thresholdPercent","typeLabel":"number"},"triggerType":{"type":"string","enum":["One Time","Recurring"],"description":"Controls if the rule will fire once or repeatedly.","isRequired":true,"uniqueKey":"rule.oneOf.6.params.triggerType","typeLabel":"enum\u003cstring>"},"triggerInterval":{"enum":["0m","12h","24h","30m","5m","60m","6h"],"type":"string","description":"Controls how often the rule will fire since the last trigger.\n\n- For `One Time` rules, this is ignored.\n- For `Recurring` rules, default is 30 minutes.","uniqueKey":"rule.oneOf.6.params.triggerInterval","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["thresholdPercent","triggerType"],"isRequired":true,"uniqueKey":"rule.oneOf.6.params","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"rule.oneOf.6","typeLabel":"Less Than · object"}],"isRequired":true,"uniqueKey":"rule","typeLabel":"Event and Market Status Changes · object | Crossing · object | Crossing Up · object | Crossing Down · object | Crossing Step · object | Greater Than · object | Less Than · object"},"channels":{"description":"The channels to send the alert to.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["Webhook"],"isRequired":true,"uniqueKey":"channels.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"settings":{"type":"object","properties":{"webhookUrl":{"type":"string","isRequired":true,"uniqueKey":"channels.items.[INDEX].settings.webhookUrl","typeLabel":"string"}},"additionalProperties":false,"required":["webhookUrl"],"isRequired":true,"uniqueKey":"channels.items.[INDEX].settings","typeLabel":"object"}},"additionalProperties":false,"required":["settings","type"],"uniqueKey":"channels.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"channels","typeLabel":"object[]"}},"additionalProperties":false,"required":["channels","rule","scope"],"uniqueKey":"","typeLabel":"object"},"examples":{"event_status_changes":{"title":"event_status_changes","value":{"scope":"Watchlist","rule":{"type":"New or closed events and markets"},"channels":[{"type":"Webhook","settings":{"webhookUrl":"https://your-webhook-endpoint.com/status-changes"}}]}},"crossing_alert":{"title":"crossing_alert","value":{"scope":"Watchlist","rule":{"type":"Crossing","params":{"threshold_percent":50,"triggerType":"Recurring","triggerInterval":"5m"}},"channels":[{"type":"Webhook","settings":{"webhookUrl":"https://your-webhook-endpoint.com/alerts"}}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"6a431a00-7ac3-4426-b1d7-2edaf2f393e0":{"description":"Subscription created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"subscriptionId":{"type":"string","isRequired":true,"uniqueKey":"subscriptionId","typeLabel":"string"}},"additionalProperties":false,"required":["subscriptionId"],"uniqueKey":"","typeLabel":"object"},"examples":{"success":{"title":"success","value":{"subscriptionId":"507f191e810c19729de860ea"}}},"exampleType":"examples"}},"exampleType":"examples"},"9dbf79f9-f5d3-486a-b0ed-bec106933966":{"description":"Bad request - validation error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"no_channels":{"title":"no_channels","value":{"error":"No channels found for subscription"}},"watchlist_not_found":{"title":"watchlist_not_found","value":{"error":"Watchlist not found"}},"duplicate_event_status_subscription":{"title":"duplicate_event_status_subscription","value":{"error":"Only one EVENT_AND_MARKET_OPEN_STATUS_CHANGES subscription is allowed per watchlist"}}},"exampleType":"examples"}},"exampleType":"examples"},"54636f43-1e9a-40f9-8b77-74223938870b":{"description":"Unauthorized - invalid or missing authentication token","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"e9539062-c106-4a9f-93ff-853fe27f4d53":{"description":"User not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"user_not_found":{"title":"user_not_found","value":{"error":"User not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"5f8205a3-827e-4158-9d65-8c49d10c723a":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"232bcc34-63eb-4716-9cc4-d9d7097285cd":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"creation_failed":{"title":"creation_failed","value":{"error":"Failed to create subscription"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e7bacb44-ab52-4ee8-9451-140496d97f04":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"6e4cdcdd-936a-4ec3-8376-119d368e8477":{"url":"https://api.nevua.markets","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"nevuamarkets","siteName":"Nevua Markets","title":"Create a watchlist subscription - Nevua Markets","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-01T15:16:18.178Z","originalFileLocation":"api-reference/alerts/create-a-watchlist-subscription.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist. When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the Webhooks documentation for more details on the webhook payloads.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Nevua Markets\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/nevuamarkets/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/nevuamarkets/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/nevuamarkets/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/nevuamarkets/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a watchlist subscription - Nevua Markets\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist. When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the Webhooks documentation for more details on the webhook payloads.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Nevua Markets\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nevuamarkets.mintlify.app/_mintlify/api/og/v2?division=Alerts\u0026amp;title=Create+a+watchlist+subscription\u0026amp;description=This+endpoint+creates+a+subscription+that+monitors+all+existing+and+newly+added+markets+in+a+watchlist.%0A%0AWhen+the+rule+condition+is+met%2C+the+subscription+will+m\u0026amp;theme=450314433cba4444625138f4\u0026amp;signature=4f17c672c9f60ffeddb7d2b3afee36a02eb546f38c26f9e19dcc94366fad83c2\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a watchlist subscription - Nevua Markets\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist. When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the Webhooks documentation for more details on the webhook payloads.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nevuamarkets.mintlify.app/_mintlify/api/og/v2?division=Alerts\u0026amp;title=Create+a+watchlist+subscription\u0026amp;description=This+endpoint+creates+a+subscription+that+monitors+all+existing+and+newly+added+markets+in+a+watchlist.%0A%0AWhen+the+rule+condition+is+met%2C+the+subscription+will+m\u0026amp;theme=450314433cba4444625138f4\u0026amp;signature=4f17c672c9f60ffeddb7d2b3afee36a02eb546f38c26f9e19dcc94366fad83c2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/nevuamarkets/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Nevua Markets\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/alerts/create-a-watchlist-subscription.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.nevua.markets/#organization\",\"name\":\"Nevua Markets\",\"url\":\"https://docs.nevua.markets\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nevuamarkets/W0J7GLoXCapcPT02/logo/nevua-markets-logo-400-150.svg?fit=max\u0026auto=format\u0026n=W0J7GLoXCapcPT02\u0026q=85\u0026s=682f654a0483aa90541cece85e4566d3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.nevua.markets#website\",\"name\":\"Nevua Markets\",\"url\":\"https://docs.nevua.markets\",\"publisher\":{\"@id\":\"https://docs.nevua.markets/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription#webpage\",\"url\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription\",\"name\":\"Create a watchlist subscription\",\"description\":\"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist. When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the Webhooks documentation for more details on the webhook payloads.\",\"dateModified\":\"2026-03-01T15:16:18.178Z\",\"isPartOf\":{\"@id\":\"https://docs.nevua.markets#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Documentation\",\"item\":\"https://docs.nevua.markets/api-reference/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a watchlist subscription\",\"item\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription#apireference\",\"headline\":\"Create a watchlist subscription\",\"name\":\"Create a watchlist subscription\",\"description\":\"This endpoint creates a subscription that monitors all existing and newly added markets in a watchlist. When the rule condition is met, the subscription will make a POST request to all the configured webhooks. See the Webhooks documentation for more details on the webhook payloads.\",\"url\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nevua.markets/api-reference/alerts/create-a-watchlist-subscription#webpage\"},\"dateModified\":\"2026-03-01T15:16:18.178Z\",\"publisher\":{\"@id\":\"https://docs.nevua.markets/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.nevua.markets#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Nevua Markets\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Nevua Markets","nav":{"global":{"anchors":[{"anchor":"Nevua Markets","icon":"house","href":"https://nevua.markets"},{"anchor":"Twitter","icon":"twitter","href":"https://x.com/NevuaMarkets"}]},"tabs":[{"tab":"User Guide","pages":[{"title":"User Guide","href":"/introduction/what-is-nevua-markets"}]},{"tab":"Developer API","groups":[{"group":"API Documentation","pages":[{"group":"Introduction","expanded":true,"pages":[{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Search","expanded":true,"pages":[{"title":"Search by keyphrases","deprecated":null,"version":null,"openapi":"openapi.json post /search","href":"/api-reference/search/search-by-keyphrases"},{"title":"Search by tags","description":"Search for events using tag slugs.\n\nYou can get the full list of tag slugs using the [/tags Polymarket API endpoint](https://docs.polymarket.com/api-reference/tags/list-tags).\n","deprecated":null,"version":null,"openapi":"openapi.json post /search/tag-slugs","href":"/api-reference/search/search-by-tags"}]},{"group":"Alerts","expanded":true,"pages":[{"title":"Create a watchlist subscription","deprecated":null,"version":null,"openapi":"openapi.json post /subscriptions/{watchlistId}","href":"/api-reference/alerts/create-a-watchlist-subscription"},{"title":"Get subscriptions","description":"Fetch all subscriptions for the authenticated user. If a watchlistId is provided, only subscriptions for that specific watchlist are returned.\n","deprecated":null,"version":null,"openapi":"openapi.json get /subscriptions/{watchlistId}","href":"/api-reference/alerts/get-subscriptions"},{"title":"Delete subscriptions","deprecated":null,"version":null,"openapi":"openapi.json post /subscriptions/delete","href":"/api-reference/alerts/delete-subscriptions"},{"title":"Webhook Payloads","href":"/api-reference/alert-webhooks/webhook-payloads"}]},{"group":"Watchlists","expanded":true,"pages":[{"title":"Create live watchlist from tags","deprecated":null,"version":null,"openapi":"openapi.json post /watchlists/create-from-tags","href":"/api-reference/watchlists/create-live-watchlist-from-tags"},{"title":"Update watchlist tags query","deprecated":null,"version":null,"openapi":"openapi.json patch /watchlists/{watchlistId}/query/tags","href":"/api-reference/watchlists/update-watchlist-tags-query"},{"title":"Get watchlists","deprecated":null,"version":null,"openapi":"openapi.json get /watchlists/{watchlistId}","href":"/api-reference/watchlists/get-watchlists"},{"title":"Delete a watchlist","deprecated":null,"version":null,"openapi":"openapi.json post /watchlists/delete","href":"/api-reference/watchlists/delete-a-watchlist"}]},{"group":"Demo","expanded":true,"pages":[{"title":"Fetch all events","deprecated":null,"version":null,"openapi":"openapi.json get /demo/events","href":"/api-reference/demo/fetch-all-events"},{"title":"Register a webhook","deprecated":null,"version":null,"openapi":"openapi.json post /demo/webhooks","href":"/api-reference/demo/register-a-webhook"},{"title":"List active webhooks","deprecated":null,"version":null,"openapi":"openapi.json get /demo/webhooks","href":"/api-reference/demo/list-active-webhooks"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"openapi.json delete /demo/webhooks/{id}","href":"/api-reference/demo/delete-a-webhook"},{"title":"Get volume and liquidity stats for a market","deprecated":null,"version":null,"openapi":"openapi.json get /demo/markets/{marketId}/volume-stats","href":"/api-reference/demo/get-volume-and-liquidity-stats-for-a-market"},{"title":"Get raw volume and liquidity timeseries for a market","deprecated":null,"version":null,"openapi":"openapi.json get /demo/markets/{marketId}/volume-raw","href":"/api-reference/demo/get-raw-volume-and-liquidity-timeseries-for-a-market"},{"title":"Webhook Notification Payload","href":"/api-reference/demo/webhook-payloads"}]}]}]}]},"basePath":"","title":"Create a watchlist subscription - Nevua Markets","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}