{"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/watchlists/get-watchlists","slug":"/api-reference/watchlists/get-watchlists","pageMetadata":{"title":"Get watchlists","description":"Retrieves all watchlists, or a specific one if `watchlistId` is provided. Watchlists are sorted by creation date - newest first.\n","deprecated":null,"version":null,"openapi":"openapi.json get /watchlists/{watchlistId}","href":"/api-reference/watchlists/get-watchlists","autogeneratedByOpenApi":true,"hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Retrieves all watchlists, or a specific one if \", _jsx(_components.code, {\n children: \"watchlistId\"\n }), \" is provided. Watchlists are sorted by creation date - newest first.\"]\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":"Get watchlists","description":"Retrieves all watchlists, or a specific one if `watchlistId` is provided. Watchlists are sorted by creation date - newest first.\n","deprecated":null,"version":null,"openapi":"openapi.json get /watchlists/{watchlistId}","href":"/api-reference/watchlists/get-watchlists","autogeneratedByOpenApi":true,"hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getWatchlists","security":["693b79da-c127-421b-a131-096ed21b42b4"],"summary":"Get watchlists","description":"Retrieves all watchlists, or a specific one if `watchlistId` is provided. Watchlists are sorted by creation date - newest first.\n","tags":["Watchlists"],"parameters":["4421a0fc-0291-4a9f-9d53-19d982b9b15b"],"responses":{"200":"d003c16e-251a-4479-aca7-5dedde4a2435","401":"3b25193a-b780-44d8-a54e-14f6fae7d7bc","429":"735dc015-31dd-47f0-8e0c-2f8e2aae7c8e","500":"4d510c51-66a9-4f82-9190-51dce6b702c7"},"method":"get","type":"path","servers":["6e4cdcdd-936a-4ec3-8376-119d368e8477"],"path":"/watchlists/{watchlistId}","baseUrlOptions":["https://api.nevua.markets"],"title":"Get watchlists","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4421a0fc-0291-4a9f-9d53-19d982b9b15b":{"name":"watchlistId","in":"path","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional watchlist ID. If not provided, returns all user's watchlists.","uniqueKey":"","typeLabel":"string"},"description":"Optional watchlist ID. If not provided, returns all user's watchlists.","example":"507f1f77bcf86cd799439011"}},"responses":{"d003c16e-251a-4479-aca7-5dedde4a2435":{"description":"Successfully retrieved watchlists","content":{"application/json":{"schema":{"type":"object","properties":{"watchLists":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].name","typeLabel":"string"},"events":{"type":"object","additionalProperties":{"type":"object","properties":{"autoFetch":{"type":"boolean","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].events.additionalProperties.autoFetch","typeLabel":"boolean"},"markets":{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].events.additionalProperties.markets.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"watchLists.items.[INDEX].events.additionalProperties.markets","typeLabel":"string[]"}},"additionalProperties":false,"required":["autoFetch","markets"],"uniqueKey":"watchLists.items.[INDEX].events.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"watchLists.items.[INDEX].events","typeLabel":"object"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].createdAt","typeLabel":"string"},"query":{"oneOf":[{"type":"object","description":"Union type for reading watchlist queries from DB.\nDuring migration, a query could be in either format.","required":["createdAt"],"properties":{"createdAt":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.createdAt","typeLabel":"string"},"includeKeyphrases":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeKeyphrases.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeKeyphrases.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeKeyphrases.oneOf.1","typeLabel":"null"}],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeKeyphrases","typeLabel":"string[] | null"},"excludeKeyphrases":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeKeyphrases.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeKeyphrases.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeKeyphrases.oneOf.1","typeLabel":"null"}],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeKeyphrases","typeLabel":"string[] | null"},"includeTags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeTags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeTags.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeTags.oneOf.1","typeLabel":"null"}],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.includeTags","typeLabel":"string[] | null"},"excludeTags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeTags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeTags.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeTags.oneOf.1","typeLabel":"null"}],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.excludeTags","typeLabel":"string[] | null"},"matchOperator":{"type":"string","enum":["AND","OR"],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0.matchOperator","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.0","typeLabel":"object"},{"type":"object","description":"Union type for reading watchlist queries from DB.\nDuring migration, a query could be in either format.","required":["createdAt","searchMatchOperator"],"properties":{"searchMatchOperator":{"type":"string","enum":["AND","OR"],"isRequired":true,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.searchMatchOperator","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.createdAt","typeLabel":"string"},"keyphrases":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.keyphrases.oneOf.0.items.[INDEX].text","typeLabel":"string"},"include":{"type":"boolean","uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.keyphrases.oneOf.0.items.[INDEX].include","typeLabel":"boolean"}},"additionalProperties":false,"required":["text"],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.keyphrases.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.keyphrases.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"text":{"type":"string"},"include":{"type":"boolean"}},"additionalProperties":false,"required":["text"]},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.keyphrases.oneOf.1","typeLabel":"null"}],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.keyphrases","typeLabel":"object[] | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"tagSlug":{"type":"string","isRequired":true,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.tags.oneOf.0.items.[INDEX].tagSlug","typeLabel":"string"},"include":{"type":"boolean","uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.tags.oneOf.0.items.[INDEX].include","typeLabel":"boolean"}},"additionalProperties":false,"required":["tagSlug"],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.tags.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.tags.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"tagSlug":{"type":"string"},"include":{"type":"boolean"}},"additionalProperties":false,"required":["tagSlug"]},"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1.tags","typeLabel":"object[] | null"}},"additionalProperties":false,"uniqueKey":"watchLists.items.[INDEX].query.oneOf.1","typeLabel":"object"}],"uniqueKey":"watchLists.items.[INDEX].query","typeLabel":"object"},"automaticallyAddMatchingEvents":{"type":"boolean","uniqueKey":"watchLists.items.[INDEX].automaticallyAddMatchingEvents","typeLabel":"boolean"},"hiddenEventIds":{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].hiddenEventIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"watchLists.items.[INDEX].hiddenEventIds","typeLabel":"string[]"},"hiddenMarketIds":{"type":"array","items":{"type":"string","uniqueKey":"watchLists.items.[INDEX].hiddenMarketIds.items.[INDEX]","typeLabel":"string"},"uniqueKey":"watchLists.items.[INDEX].hiddenMarketIds","typeLabel":"string[]"},"updatedAt":{"type":"string","uniqueKey":"watchLists.items.[INDEX].updatedAt","typeLabel":"string"}},"additionalProperties":false,"required":["createdAt","events","id","name"],"uniqueKey":"watchLists.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"watchLists","typeLabel":"object[]"}},"additionalProperties":false,"required":["watchLists"],"uniqueKey":"","typeLabel":"object"},"examples":{"all_watchlists":{"title":"all_watchlists","value":{"watchLists":[{"id":"507f1f77bcf86cd799439011","name":"Election Markets","query":{"keyphrases":[{"text":"election","include":true}],"tags":[],"searchMatchOperator":"OR","createdAt":"2024-09-26T10:30:00.000Z"},"automaticallyAddMatchingEvents":true,"events":{"event123":{"autoFetch":true,"markets":["market456","market789"]}},"createdAt":"2024-09-26T10:30:00.000Z","updatedAt":"2024-09-26T11:00:00.000Z"}]}},"specific_watchlist":{"title":"specific_watchlist","value":{"watchLists":[{"id":"507f1f77bcf86cd799439011","name":"Sports Betting","query":{"keyphrases":[],"tags":[{"text":"sports","include":true}],"searchMatchOperator":"AND","createdAt":"2024-09-26T10:30:00.000Z"},"automaticallyAddMatchingEvents":true,"events":{},"createdAt":"2024-09-26T10:30:00.000Z"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"3b25193a-b780-44d8-a54e-14f6fae7d7bc":{"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"},"735dc015-31dd-47f0-8e0c-2f8e2aae7c8e":{"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"},"4d510c51-66a9-4f82-9190-51dce6b702c7":{"description":"Internal server error","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"}},"security":{"693b79da-c127-421b-a131-096ed21b42b4":{"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":"Get watchlists - Nevua Markets","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-01T15:16:18.253Z","originalFileLocation":"api-reference/watchlists/get-watchlists.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=\"Retrieves all watchlists, or a specific one if watchlistId is provided. Watchlists are sorted by creation date - newest first.\">\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=\"Get watchlists - Nevua Markets\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves all watchlists, or a specific one if watchlistId is provided. Watchlists are sorted by creation date - newest first.\">\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/watchlists/get-watchlists\">\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=Watchlists\u0026amp;title=Get+watchlists\u0026amp;description=Retrieves+all+watchlists%2C+or+a+specific+one+if+%60watchlistId%60+is+provided.+Watchlists+are+sorted+by+creation+date+-+newest+first.%0A\u0026amp;theme=450314433cba4444625138f4\u0026amp;signature=9f147be4ff0c1d038362f0ca93359cc64ecb3c36e57afdf3915be2bf6969727f\">\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=\"Get watchlists - Nevua Markets\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves all watchlists, or a specific one if watchlistId is provided. Watchlists are sorted by creation date - newest first.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nevuamarkets.mintlify.app/_mintlify/api/og/v2?division=Watchlists\u0026amp;title=Get+watchlists\u0026amp;description=Retrieves+all+watchlists%2C+or+a+specific+one+if+%60watchlistId%60+is+provided.+Watchlists+are+sorted+by+creation+date+-+newest+first.%0A\u0026amp;theme=450314433cba4444625138f4\u0026amp;signature=9f147be4ff0c1d038362f0ca93359cc64ecb3c36e57afdf3915be2bf6969727f\">\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/watchlists/get-watchlists\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/watchlists/get-watchlists.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/watchlists/get-watchlists#webpage\",\"url\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists\",\"name\":\"Get watchlists\",\"description\":\"Retrieves all watchlists, or a specific one if watchlistId is provided. Watchlists are sorted by creation date - newest first.\",\"dateModified\":\"2026-03-01T15:16:18.253Z\",\"isPartOf\":{\"@id\":\"https://docs.nevua.markets#website\"},\"breadcrumb\":{\"@id\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Documentation\",\"item\":\"https://docs.nevua.markets/api-reference/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Watchlists\",\"item\":\"https://docs.nevua.markets/api-reference/watchlists/create-live-watchlist-from-tags\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get watchlists\",\"item\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists#apireference\",\"headline\":\"Get watchlists\",\"name\":\"Get watchlists\",\"description\":\"Retrieves all watchlists, or a specific one if watchlistId is provided. Watchlists are sorted by creation date - newest first.\",\"url\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists\",\"mainEntityOfPage\":{\"@id\":\"https://docs.nevua.markets/api-reference/watchlists/get-watchlists#webpage\"},\"dateModified\":\"2026-03-01T15:16:18.253Z\",\"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","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","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","description":"Replaces the tag-based query of an existing watchlist. This endpoint requires that the watchlist\ncurrently uses tags (not keyphrases) and that at least one valid tag is provided.\n\n## Request Formats\n\n### V2 Format (Recommended)\nUses explicit `includeTags`/`excludeTags` arrays:\n```json\n{\n \"includeTags\": [\"sports\", \"esports\"],\n \"excludeTags\": [\"politics\"],\n \"matchOperator\": \"OR\"\n}\n```\n\n### V1 Format (Deprecated - will be removed in future version)\nUses `tags` array with `include` boolean:\n```json\n{\n \"tags\": [\n {\"tagSlug\": \"sports\", \"include\": true}\n ],\n \"searchMatchOperator\": \"OR\"\n}\n```\n","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","description":"Permanently deletes a watchlist. Any subscriptions created for this watchlist will be cascade-deleted as well.\n\nThis action cannot be undone.\n","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":"Get watchlists - 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"]}