About Gravia API and how to get up and running with it
If you’re looking for the web app / trading terminal, please visit https://gravia.trade
Gravia provides some of the best analytics and trading capabilities in the prediction market space, particularly polymarket. Our APIs are tailored to be used by people that wish to have the best and latest of data all the time, this is useful for general bot makers as well as other individuals that wish not to reinvent the wheel.We are open to suggestions and requests via our Discord community. The API is currently in heavy active development.To get up and running with us, please checkout the quickstart guide and the API reference. Most APIs are authenticated and won’t work without an API key.
Quickstart
Get up and running with Gravia APIs
{"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":"index","slug":"/","pageMetadata":{"title":"Introduction","description":"About Gravia API and how to get up and running with it","href":"/index"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"About Gravia API and how to get up and running with it\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,..._provideComponents(),...props.components},{Card,Note}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`If you’re looking for the web app / trading terminal, please visit `,_jsx(_components.a,{href:`https://gravia.trade`,children:`https://gravia.trade`})]})}),`\n`,_jsx(_components.p,{children:`Gravia provides some of the best analytics and trading capabilities in the prediction market space, particularly polymarket. Our APIs are tailored to be used by people that wish to have the best and latest of data all the time, this is useful for general bot makers as well as other individuals that wish not to reinvent the wheel.`}),`\n`,_jsx(_components.p,{children:`We are open to suggestions and requests via our Discord community. The API is currently in heavy active development.`}),`\n`,_jsx(_components.p,{children:`To get up and running with us, please checkout the quickstart guide and the API reference. Most APIs are authenticated and won’t work without an API key.`}),`\n`,_jsx(Card,{title:`Quickstart`,icon:`rocket`,href:`/quickstart`,children:_jsx(_components.p,{children:`Get up and running with Gravia APIs`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Introduction","description":"About Gravia API and how to get up and running with it","href":"/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"gravia-trade","siteName":"Gravia Data API","title":"Introduction - Gravia Data API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-15T08:06:17.867Z","originalFileLocation":"index.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=\"About Gravia API and how to get up and running with it\">\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=\"Introduction - Gravia Data API\">\u003cmeta data-mint-head property=\"og:description\" content=\"About Gravia API and how to get up and running with it\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gravia Data API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gravia.trade\">\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=Getting+Started\u0026amp;title=Introduction\u0026amp;description=About+Gravia+API+and+how+to+get+up+and+running+with+it\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=3b08ff2e2075965177180392d87dd7cf20123b43689530a48151e0ff33c180f3\">\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=\"Introduction - Gravia Data API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"About Gravia API and how to get up and running with it\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gravia-trade.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Introduction\u0026amp;description=About+Gravia+API+and+how+to+get+up+and+running+with+it\u0026amp;theme=8c421f2e72c1c7001e92ec31\u0026amp;signature=3b08ff2e2075965177180392d87dd7cf20123b43689530a48151e0ff33c180f3\">\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\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/index.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/#webpage\",\"url\":\"https://docs.gravia.trade/\",\"name\":\"Introduction\",\"description\":\"About Gravia API and how to get up and running with it\",\"dateModified\":\"2026-07-15T08:06:17.867Z\",\"isPartOf\":{\"@id\":\"https://docs.gravia.trade#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gravia.trade/#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gravia.trade/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.gravia.trade/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Introduction\",\"item\":\"https://docs.gravia.trade/\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gravia.trade/#article\",\"headline\":\"Introduction\",\"name\":\"Introduction\",\"description\":\"About Gravia API and how to get up and running with it\",\"url\":\"https://docs.gravia.trade/\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gravia.trade/#webpage\"},\"dateModified\":\"2026-07-15T08:06:17.867Z\",\"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","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":""},{"title":"Quickstart","description":"How to obtain an API key and get started with using Gravia APIs","href":"/quickstart"},{"title":"Pricing","href":"/pricing"},{"title":"Rate Limits","href":"/rate-limits"},{"title":"Webhooks","href":"/webhooks"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/webhooks/list-owned-webhooks"}]}]},"basePath":"","title":"Introduction - Gravia Data API","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":[],"chunks":[]}