Returns active categories in catalog order, optionally restricted to a
dotted prefix. The flat list preserves the category hierarchy through
each item’s parent_slug.
GET
/
api
/
v1
/
markets
/
categories
/
list
List market categories
curl --request GET \ --url https://data.gravia.trade/api/v1/markets/categories/list \ --header 'Authorization: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gravia Data API","colors":{"primary":"#9FFBFE","light":"#B8F7F8","dark":"#52CCD0"},"logo":{"light":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Gravia-black-logo.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=d20027ef4daf7f22158c1c43c271a664","dark":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Gravia-White-logo.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=ea11483c2fba835a236dce5eaafc0971"},"favicon":{"light":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Favicon-black.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=7592a349f8a038bd79006469a83390b7","dark":"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Favicon-black.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=7592a349f8a038bd79006469a83390b7"},"background":{"color":{"light":"#ffffff","dark":"#09090B"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"},{"href":"https://discord.gg/REeFwe5HyN","label":"Discord"}]},"footer":{"socials":{"x":"https://x.com/graviahq","discord":"https://discord.gg/REeFwe5HyN"}},"fonts":{"family":"DM Sans"},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"schema":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gravia-trade","hasAudioNarration":false,"actualSubdomain":"gravia-trade","customDomains":["docs.gravia.trade"],"gitSource":{"type":"github","owner":"mintlify-community","repo":"docs-gravia-trade-52698928","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"5160409f-d378-44bb-8ff7-93078be2816f","liveDeploymentHistoryId":"6abcdb7489c801142748f92e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6abcdb7489c801142748f92e"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6abcdb7489c801142748f92e","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":22},{"language":"default","tag":"Webhooks","count":9},{"language":"default","tag":"Users","count":7},{"language":"default","tag":"Documentation","count":5},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Markets","count":3},{"language":"default","tag":"Streams","count":2},{"language":"default","tag":"Operational","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/markets/list-market-categories","slug":"/api-reference/markets/list-market-categories","pageMetadata":{"title":"List market categories","description":"Returns active categories in catalog order, optionally restricted to a\ndotted prefix. The flat list preserves the category hierarchy through\neach item's `parent_slug`.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/categories/list","href":"/api-reference/markets/list-market-categories","autogeneratedByOpenApi":true},"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: [\"Returns active categories in catalog order, optionally restricted to a\\ndotted prefix. The flat list preserves the category hierarchy through\\neach item’s \", _jsx(_components.code, {\n children: \"parent_slug\"\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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"List market categories","description":"Returns active categories in catalog order, optionally restricted to a\ndotted prefix. The flat list preserves the category hierarchy through\neach item's `parent_slug`.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/categories/list","href":"/api-reference/markets/list-market-categories","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List market categories","description":"Returns active categories in catalog order, optionally restricted to a\ndotted prefix. The flat list preserves the category hierarchy through\neach item's `parent_slug`.\n","operationId":"listMarketCategories","x-feature-stage":"stable","tags":["Markets"],"parameters":["e017b6ed-0dd8-400e-a3db-eb2e9247da82"],"responses":{"200":"606f67ab-86f3-444f-b942-23003c17f25c","401":"aed793f5-10cb-43cc-98aa-2b42af42d9aa","429":"d23683e7-1725-4809-b1fa-a2066c8efd25","500":"db421d45-a87d-49aa-8330-12f78a8f10ca"},"method":"get","type":"path","servers":["95aa4c4e-3c2a-41df-afae-71836d5c0fa7"],"security":["badce155-6f9b-410a-adb9-ddf6a04af289"],"path":"/api/v1/markets/categories/list","baseUrlOptions":["https://data.gravia.trade"],"title":"List market categories","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e017b6ed-0dd8-400e-a3db-eb2e9247da82":{"name":"prefix","in":"query","required":false,"description":"Dotted category prefix to list. The response includes the category\nwhose slug exactly matches the prefix and all of its descendants.\n","schema":{"type":"string","minLength":1,"isRequired":false,"description":"Dotted category prefix to list. The response includes the category\nwhose slug exactly matches the prefix and all of its descendants.\n","uniqueKey":"","typeLabel":"string"},"example":"crypto.prices"}},"responses":{"606f67ab-86f3-444f-b942-23003c17f25c":{"description":"Active market categories.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}},"X-API-Version":{"description":"API version that handled this request.","schema":{"type":"string","enum":["v1"]}},"RateLimit-Limit":{"description":"Request limit for the currently most restrictive policy tier.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests remaining in the currently most restrictive policy tier.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Whole seconds until capacity returns in the reported policy tier.","schema":{"type":"integer","minimum":0}},"Cache-Control":{"description":"Public caching policy for the category catalog.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["categories"],"properties":{"categories":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["slug","parent_slug","label","description"],"properties":{"slug":{"type":"string","minLength":1,"description":"Dotted category slug.","isRequired":true,"uniqueKey":"categories.items.[INDEX].slug","typeLabel":"string"},"parent_slug":{"type":"string","description":"Parent category slug, or an empty string for a root category.","isRequired":true,"uniqueKey":"categories.items.[INDEX].parent_slug","typeLabel":"string"},"label":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"categories.items.[INDEX].label","typeLabel":"string"},"description":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"categories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"categories","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"catalog":{"title":"catalog","value":{"categories":[{"slug":"crypto","parent_slug":"","label":"Crypto","description":"Crypto markets"},{"slug":"crypto.prices","parent_slug":"crypto","label":"Prices","description":"Crypto price markets"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"aed793f5-10cb-43cc-98aa-2b42af42d9aa":{"description":"The request could not be completed.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"user is required","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d23683e7-1725-4809-b1fa-a2066c8efd25":{"description":"The API-key and endpoint sliding-window policy was exceeded.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Request limit for the currently most restrictive policy tier.","schema":{"type":"integer","minimum":1}},"RateLimit-Remaining":{"description":"Requests remaining in the currently most restrictive policy tier.","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"Whole seconds until capacity returns in the reported policy tier.","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Whole seconds before the rate-limited request should be retried.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limit_exceeded","message":"rate limit exceeded","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limit_exceeded","message":"rate limit exceeded","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"examples"}},"exampleType":"examples"},"db421d45-a87d-49aa-8330-12f78a8f10ca":{"description":"The request could not be completed.","headers":{"X-Request-ID":{"description":"Correlation ID supplied by the client or generated by the server.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code. Branch on this rather than on\n`message`, which may be reworded at any time.\n\n| Code | Status | Meaning |\n| --- | --- | --- |\n| `invalid_request` | 400 | A parameter is missing, malformed, or out of range. |\n| `unauthorized` | 401 | The API key is missing, unknown, or revoked. |\n| `cors_origin_denied` | 403 | The browser origin is not on the deployment's allowlist. |\n| `not_found` | 404 | The requested resource does not exist. |\n| `profile_not_found` | 404 | The `user` value did not resolve to a known profile. |\n| `method_not_allowed` | 405 | The path exists but not for this HTTP method. |\n| `rate_limit_exceeded` | 429 | A sliding-window rate limit was exceeded; honor `Retry-After`. |\n| `stream_limit_reached` | 429 | This API key reached its concurrent allowance for the stream; close an existing connection instead of retrying. |\n| `internal_error` | 500 | Unexpected server-side failure. |\n| `service_unavailable` | 503 | A required backend is not configured or reachable. |\n| `temporarily_unavailable` | 503 | A backend is briefly degraded; retry after a short pause. |\n","example":"invalid_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error description. Not a stable contract.","example":"user is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation ID for support and log lookup, mirroring the\n`X-Request-ID` response header.\n","example":"01f6c90f31d24db3a25c7dba6ca071ee","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"user is required","request_id":"01f6c90f31d24db3a25c7dba6ca071ee"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"badce155-6f9b-410a-adb9-ddf6a04af289":{"APIKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Raw database-backed API key.","scopes":[]}}},"servers":{"95aa4c4e-3c2a-41df-afae-71836d5c0fa7":{"url":"https://data.gravia.trade","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Raw database-backed API key.","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Raw database-backed API key.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKey","name":"Authorization"}],"title":"APIKey"}]},"originalFileLocation":"https://data.gravia.trade/"},"subdomain":"gravia-trade","siteName":"Gravia Data API","title":"List market categories - Gravia Data API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-27T11:39:29.465Z","originalFileLocation":"api-reference/markets/list-market-categories.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=\"Returns active categories in catalog order, optionally restricted to a dotted prefix. The flat list preserves the category hierarchy through each item\u0026#x27;s parent_slug.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gravia Data API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List market categories - Gravia Data API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns active categories in catalog order, optionally restricted to a dotted prefix. The flat list preserves the category hierarchy through each item\u0026#x27;s parent_slug.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gravia Data API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gravia.trade/api-reference/markets/list-market-categories\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gravia-trade.mintlify.app/_mintlify/api/og/v2?division=Markets\u0026amp;title=List+market+categories\u0026amp;description=Returns+active+categories+in+catalog+order%2C+optionally+restricted+to+a%0Adotted+prefix.+The+flat+list+preserves+the+category+hierarchy+through%0Aeach+item%27s+%60parent\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=a0032e70fc58e5b0e31759403205de68a80c84c3dfd06a81622a55418df82f45\">\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=\"List market categories - Gravia Data API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns active categories in catalog order, optionally restricted to a dotted prefix. The flat list preserves the category hierarchy through each item\u0026#x27;s parent_slug.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gravia-trade.mintlify.app/_mintlify/api/og/v2?division=Markets\u0026amp;title=List+market+categories\u0026amp;description=Returns+active+categories+in+catalog+order%2C+optionally+restricted+to+a%0Adotted+prefix.+The+flat+list+preserves+the+category+hierarchy+through%0Aeach+item%27s+%60parent\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=a0032e70fc58e5b0e31759403205de68a80c84c3dfd06a81622a55418df82f45\">\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=\"/mintlify-assets/_mintlify/favicons/gravia-trade/UCUg-2SVPMUpHKiA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gravia Data API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9FFBFE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gravia.trade/api-reference/markets/list-market-categories\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/markets/list-market-categories.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gravia.trade/#organization\",\"name\":\"Gravia Data API\",\"url\":\"https://docs.gravia.trade\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/gravia-trade/q65mj9SyvyR5CJGQ/images/Gravia-black-logo.svg?fit=max\u0026auto=format\u0026n=q65mj9SyvyR5CJGQ\u0026q=85\u0026s=d20027ef4daf7f22158c1c43c271a664\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gravia.trade#website\",\"name\":\"Gravia Data API\",\"url\":\"https://docs.gravia.trade\",\"publisher\":{\"@id\":\"https://docs.gravia.trade/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories#webpage\",\"url\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories\",\"name\":\"List market categories\",\"description\":\"Returns active categories in catalog order, optionally restricted to a dotted prefix. The flat list preserves the category hierarchy through each item's parent_slug.\",\"dateModified\":\"2026-09-27T11:39:29.465Z\",\"isPartOf\":{\"@id\":\"https://docs.gravia.trade#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Markets\",\"item\":\"https://docs.gravia.trade/api-reference/markets/get-the-current-crypto-updown-market\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List market categories\",\"item\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories#apireference\",\"headline\":\"List market categories\",\"name\":\"List market categories\",\"description\":\"Returns active categories in catalog order, optionally restricted to a dotted prefix. The flat list preserves the category hierarchy through each item's parent_slug.\",\"url\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gravia.trade/api-reference/markets/list-market-categories#webpage\"},\"dateModified\":\"2026-09-27T11:39:29.465Z\",\"publisher\":{\"@id\":\"https://docs.gravia.trade/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gravia.trade#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gravia Data API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Gravia Data API","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Webhooks","pages":[{"title":"List owned webhooks","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks","href":"/api-reference/webhooks/list-owned-webhooks"},{"title":"Create a webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ post /v1/webhooks","href":"/api-reference/webhooks/create-a-webhook"},{"title":"List supported webhook events","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks/events","href":"/api-reference/webhooks/list-supported-webhook-events"},{"title":"Get an owned webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks/{id}","href":"/api-reference/webhooks/get-an-owned-webhook"},{"title":"Update a webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ put /v1/webhooks/{id}","href":"/api-reference/webhooks/update-a-webhook"},{"title":"Delete a webhook","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ delete /v1/webhooks/{id}","href":"/api-reference/webhooks/delete-a-webhook"},{"title":"Rotate signing secret","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ post /v1/webhooks/{id}/rotate-secret","href":"/api-reference/webhooks/rotate-signing-secret"},{"title":"Send a test callback","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ post /v1/webhooks/{id}/test","href":"/api-reference/webhooks/send-a-test-callback"},{"title":"List terminal delivery logs","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /v1/webhooks/{id}/logs","href":"/api-reference/webhooks/list-terminal-delivery-logs"}]},{"group":"Operational","pages":[{"title":"Health check","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /health","href":"/api-reference/operational/health-check"}]},{"group":"Markets","pages":[{"title":"Get the current crypto up/down market","description":"Returns the market whose half-open time window contains the current\nserver time for the requested crypto and interval. When no candidate\ncontains the current time, the market with the closest end time is\nreturned. The response also includes the next known market slug.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/crypto/current","href":"/api-reference/markets/get-the-current-crypto-updown-market"},{"title":"List market categories","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/categories/list","href":"/api-reference/markets/list-market-categories"},{"title":"Get a market's price to beat","description":"Resolves a crypto up/down market slug, condition ID, or token ID to its\nopening reference price. The response always contains the canonical\nmarket slug. Recognized future and recently-opened markets return 200\nwith timing instructions in the response.\n","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/markets/crypto/price-to-beat","href":"/api-reference/markets/get-a-markets-price-to-beat"}]},{"group":"Users","pages":[{"title":"Get a user's trades and on-chain activities","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/activities","href":"/api-reference/users/get-a-users-trades-and-on-chain-activities"},{"title":"Get a user's trades with markouts","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/trades/markouts","href":"/api-reference/users/get-a-users-trades-with-markouts"},{"title":"Get markouts grouped by counterparty","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/trades/counterparties","href":"/api-reference/users/get-markouts-grouped-by-counterparty"},{"title":"Get one profile's category metrics","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/categories","href":"/api-reference/users/get-one-profiles-category-metrics"},{"title":"Get a user's positions","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/positions","href":"/api-reference/users/get-a-users-positions"},{"title":"Get a concise user profile","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/profile","href":"/api-reference/users/get-a-concise-user-profile"},{"title":"Get a user's taker tier","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/users/taker-tier","href":"/api-reference/users/get-a-users-taker-tier"}]},{"group":"Streams","pages":[{"title":"WebSocket stream of Chainlink crypto prices","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/streams/crypto-prices","href":"/api-reference/streams/websocket-stream-of-chainlink-crypto-prices"},{"title":"WebSocket stream of live trades, activities and conversions","deprecated":null,"version":null,"openapi":"https://data.gravia.trade/ get /api/v1/streams/transactions","href":"/api-reference/streams/websocket-stream-of-live-trades-activities-and-conversions"}]}]}]},"basePath":"","title":"List market categories - Gravia Data API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}