Authenticate requests with a Bearer token or an api_key query parameter.
Each API request requires authentication to identify the member. Authentication is provided
through an access token. The token is unique, issued for each client.You can authenticate in one of two ways.
Prefer the Authorization header over the query parameter — URLs are often logged by
proxies and analytics, which can leak keys passed as query parameters.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CryptoQuant API","description":"On-chain data, market data, and aggregate blockchain statistics through simple and powerful endpoints.","colors":{"primary":"#4F37E4","light":"#7775FF","dark":"#321FA2"},"logo":{"light":"https://mintcdn.com/cryptoquant/cSlSER2PqavNh86I/logo/light.svg?fit=max\u0026auto=format\u0026n=cSlSER2PqavNh86I\u0026q=85\u0026s=78ffb16e4fe60107da647c7c6c8a4f07","dark":"https://mintcdn.com/cryptoquant/cSlSER2PqavNh86I/logo/dark.svg?fit=max\u0026auto=format\u0026n=cSlSER2PqavNh86I\u0026q=85\u0026s=c9b43dba206fd62465772088a2d5e0b9"},"favicon":"https://mintcdn.com/cryptoquant/7KGUBe3wMDPdp_XP/favicon.png?fit=max\u0026auto=format\u0026n=7KGUBe3wMDPdp_XP\u0026q=85\u0026s=b3b9d04542c1e8e7fe3876977b142f64","background":{"color":{"light":"#F9F9FA","dark":"#0F0F11"}},"navbar":{"primary":{"type":"button","label":"Get API Key","href":"https://cryptoquant.com/settings/api"}},"footer":{"socials":{"x":"https://x.com/cryptoquant_com","website":"https://cryptoquant.com"}},"seo":{"metatags":{"og:site_name":"CryptoQuant API","og:type":"website","twitter:card":"summary_large_image","twitter:site":"@cryptoquant_com","twitter:creator":"@cryptoquant_com"},"indexing":"all"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cryptoquant","hasAudioNarration":false,"actualSubdomain":"cryptoquant","customDomains":["docs.cryptoquant.com"],"gitSource":{"type":"github","owner":"cryptoquantofficial","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"a6adeb18-6822-4a51-9931-f5eea15d9905","liveDeploymentHistoryId":"6ae00ec8a3c38bf35dbde31e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae00ec8a3c38bf35dbde31e"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae00ec8a3c38bf35dbde31e","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API v1","count":243},{"language":"default","tag":"API v2","count":90},{"language":"default","tag":"Data Guide","count":75},{"language":"default","tag":"On-chain Data","count":56},{"language":"default","tag":"ETH Network Data","count":44},{"language":"default","tag":"UTxO Data/Indicators","count":25},{"language":"default","tag":"BTC Network Indicator","count":22},{"language":"default","tag":"Market Data","count":17},{"language":"default","tag":"Get Started","count":15},{"language":"default","tag":"Sentiment Data","count":15}]},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--cq-font-sans:-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,\n 'Helvetica Neue', Arial, 'Noto Sans KR', sans-serif, 'Apple Color Emoji',\n 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';--cq-primary-600:rgb(50 31 162);--cq-primary-500:rgb(79 55 228);--cq-primary-300:rgb(173 176 255);--cq-primary-100:rgb(235 236 255);--cq-primary-50:rgb(245 246 255);--cq-text-primary:rgb(18 18 20);--cq-text-secondary:rgb(114 113 125);--cq-background-base:rgb(249 249 250);--cq-layer-1:rgb(255 255 255);--cq-border-light:rgb(241 241 244);--cq-border-subtle:rgb(228 228 235);--cq-border-moderate:rgb(214 213 222);--cq-layer-hover-tint:rgba(173, 176, 255, 0.1);--cq-button-primary:rgb(79 55 228);--cq-button-primary-hover:rgb(50 31 162);--cq-radius:5px;--cq-radius-button:6px}.dark{--cq-primary-600:rgb(132 130 255);--cq-primary-500:rgb(119 117 255);--cq-primary-300:rgb(71 62 169);--cq-primary-100:rgb(31 27 76);--cq-primary-50:rgb(24 23 41);--cq-text-primary:rgb(249 249 253);--cq-text-secondary:rgb(145 145 159);--cq-background-base:rgb(15 15 17);--cq-layer-1:rgb(24 24 29);--cq-border-light:rgb(33 33 40);--cq-border-subtle:rgb(45 45 55);--cq-border-moderate:rgb(64 63 75);--cq-layer-hover-tint:rgba(71, 62, 169, 0.1);--cq-button-primary:rgb(92 89 229);--cq-button-primary-hover:rgb(132 130 255)}body,button,h1,h2,h3,h4,h5,h6,input,select,textarea{font-family:var(--cq-font-sans)!important}h1,h1#page-title,h2,h3,h4{font-weight:600}h1,h2,h3,h4,h5,h6{letter-spacing:.01em!important}h1#page-title{letter-spacing:.02em!important}#topbar-cta-button a,#topbar-cta-button a span,a.rounded-lg,a.rounded-md,a.rounded-xl,button.rounded-lg,button.rounded-md,button.rounded-xl{border-radius:var(--cq-radius-button)!important}#topbar-cta-button a,#topbar-cta-button a span{background:var(--cq-button-primary)!important;color:rgb(255 255 255)!important;transition:background-color .1s ease-out}#topbar-cta-button a:hover,#topbar-cta-button a:hover span{background:var(--cq-button-primary-hover)!important}a.nav-tabs-item[href=\"/v2/overview\"]::after{content:\"Beta\";font-size:.625rem;font-weight:600;line-height:1;letter-spacing:.02em;padding:3px 5px;border-radius:var(--cq-radius);color:var(--cq-primary-500);background:var(--cq-primary-100)}.cq-detail{display:flex;flex-direction:column;gap:.9rem}.cq-chips{display:flex;flex-wrap:wrap;align-items:center;gap:.4rem}.cq-chip-label{font-size:.68rem;font-weight:600;text-transform:uppercase;letter-spacing:.05em;color:var(--cq-text-secondary);margin-right:.2rem}.cq-chips code,.cq-lat{border:1px solid var(--cq-border-subtle)}.cq-chips code{background:var(--cq-primary-50);color:var(--cq-primary-600);padding:.12em .6em;border-radius:999px;font-size:.78rem}.cq-lat{border-radius:10px;overflow:hidden}.cq-lat__cap{padding:.5rem .9rem;font-size:.75rem;line-height:1.4;color:var(--cq-text-secondary);background:var(--cq-layer-1);border-bottom:1px solid var(--cq-border-light)}.cq-lat__head,.cq-lat__row{display:grid;grid-template-columns:.8fr 1fr 1fr;gap:.5rem;padding:.55rem .9rem;align-items:center}.cq-tip{display:inline-flex;align-items:center;justify-content:center;width:14px;height:14px;margin-left:.3rem;border:1px solid currentColor;border-radius:50%;font-size:.6rem;line-height:1;cursor:help;position:relative;vertical-align:middle}.cq-tip::after{content:attr(data-tip);position:absolute;top:145%;left:50%;transform:translateX(-50%);width:250px;max-width:60vw;padding:.5rem .65rem;border-radius:8px;background:var(--cq-text-primary);color:var(--cq-layer-1);font-size:.72rem;font-weight:400;line-height:1.45;letter-spacing:normal;text-transform:none;text-align:left;opacity:0;pointer-events:none;transition:opacity .12s ease;z-index:20}.cq-tip:hover::after{opacity:1}.cq-lat__head{background:var(--cq-primary-50);color:var(--cq-primary-600);font-size:.68rem;font-weight:600;text-transform:uppercase;letter-spacing:.04em}.cq-lat__head span[title]{cursor:help;text-decoration:underline dotted;text-underline-offset:2px}.cq-lat-legend b{color:var(--cq-text-primary)}.cq-lat__row{border-top:1px solid var(--cq-border-light);font-size:.875rem}.cq-lat__row:hover{background:var(--cq-layer-hover-tint)}.cq-num{font-variant-numeric:tabular-nums}.cq-lat-group__name a,.cq-meta a{color:var(--cq-primary-500);text-decoration:none}.cq-meta a:hover{text-decoration:underline}.cq-lat-group__name code,.cq-lat-legend,.cq-meta{font-size:.78rem;color:var(--cq-text-secondary)}.cq-lat-legend{line-height:1.45;margin-bottom:.25rem}.cq-lat-group{display:flex;flex-direction:column;gap:.5rem}.cq-lat-group+.cq-lat-group{margin-top:1.25rem;padding-top:1.25rem;border-top:1px solid var(--cq-border-light)}.cq-lat-group__name{display:flex;align-items:baseline;flex-wrap:wrap;gap:.55rem;font-weight:600}.cq-lat-group__name code{font-weight:400}.cq-api-badge{display:inline-block;padding:.1rem .55rem;margin:0 .35rem .5rem 0;border-radius:999px;font-size:.75rem;font-weight:600;line-height:1.25rem;letter-spacing:.01em;border:1px solid transparent;vertical-align:middle}.cq-api-v1{color:rgb(50 31 162);background:rgb(235 236 255);border-color:rgb(173 176 255)}.cq-api-v2{color:rgb(3 105 161);background:rgb(224 242 254);border-color:rgb(125 211 252)}.dark .cq-api-v1{color:rgb(173 176 255);background:rgb(31 27 76);border-color:rgb(71 62 169)}.dark .cq-api-v2{color:rgb(125 211 252);background:rgb(12 44 72);border-color:rgb(3 105 161)}"}],"page":{"pagePath":"guides/authentication","slug":"/guides/authentication","pageMetadata":{"title":"Authentication","description":"Authenticate requests with a Bearer token or an api_key query parameter.","icon":"key","href":"/guides/authentication"},"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: \"Authenticate requests with a Bearer token or an api_key query parameter.\"\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={code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Each API request requires authentication to identify the member. Authentication is provided\nthrough an access token. The token is unique, issued for each client.`}),`\n`,_jsx(_components.p,{children:`You can authenticate in one of two ways.`}),`\n`,_jsx(Heading,{level:`2`,id:`access-token-recommended`,children:`Access token (recommended)`}),`\n`,_jsxs(_components.p,{children:[`Include the `,_jsx(_components.code,{children:`Authorization`}),` HTTP header with `,_jsx(_components.code,{children:`Bearer \u003cYOUR_API_KEY>`}),` in every request.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /v1/{PATH} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Host`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` api.cryptoquant.com`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Authorization`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Bearer \u003cYOUR_API_KEY>`})]}),`\n`]})})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`4`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer \"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` +`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`headers)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`3`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameter`,children:`Query parameter`}),`\n`,_jsxs(_components.p,{children:[`Alternatively, pass your key as the `,_jsx(_components.code,{children:`api_key`}),` query parameter.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /v1/{PATH}?api_key={API_KEY} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Host`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` api.cryptoquant.com`})]}),`\n`]})})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`3`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.get(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`})`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`1`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` response`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`?api_key=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Prefer the `,_jsx(_components.code,{children:`Authorization`}),` header over the query parameter — URLs are often logged by\nproxies and analytics, which can leak keys passed as query parameters.`]})})]})}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":{"config":{},"pageMetadata":{"title":"Authentication","description":"Authenticate requests with a Bearer token or an api_key query parameter.","icon":"key","href":"/guides/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Access token (recommended)","slug":"access-token-recommended","depth":2,"children":[]},{"title":"Query parameter","slug":"query-parameter","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cryptoquant/b8d3edb0b79b8166/amplitude-tracking.js"],"subdomain":"cryptoquant","siteName":"CryptoQuant API","title":"Authentication - CryptoQuant API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-09T06:39:43.668Z","originalFileLocation":"guides/authentication.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=\"Authenticate requests with a Bearer token or an api_key query parameter.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CryptoQuant 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/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_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/cryptoquant/yvh6pkhU1hdATa46/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - CryptoQuant API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Authenticate requests with a Bearer token or an api_key query parameter.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CryptoQuant API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cryptoquant.com/guides/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cryptoquant.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Authentication\u0026amp;description=Authenticate+requests+with+a+Bearer+token+or+an+api_key+query+parameter.\u0026amp;theme=913b71b3123fe3e4f66756d6\u0026amp;signature=d0a885922811da6a5e71b6a22857ee74f565afd455b8b614c1fd6f70dbecb2fe\">\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=\"Authentication - CryptoQuant API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Authenticate requests with a Bearer token or an api_key query parameter.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cryptoquant.mintlify.app/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Authentication\u0026amp;description=Authenticate+requests+with+a+Bearer+token+or+an+api_key+query+parameter.\u0026amp;theme=913b71b3123fe3e4f66756d6\u0026amp;signature=d0a885922811da6a5e71b6a22857ee74f565afd455b8b614c1fd6f70dbecb2fe\">\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/cryptoquant/yvh6pkhU1hdATa46/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CryptoQuant API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F37E4\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@cryptoquant_com\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cryptoquant.com/guides/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cryptoquant.com/#organization\",\"name\":\"CryptoQuant API\",\"url\":\"https://docs.cryptoquant.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cryptoquant/cSlSER2PqavNh86I/logo/light.svg?fit=max\u0026auto=format\u0026n=cSlSER2PqavNh86I\u0026q=85\u0026s=78ffb16e4fe60107da647c7c6c8a4f07\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cryptoquant.com#website\",\"name\":\"CryptoQuant API\",\"url\":\"https://docs.cryptoquant.com\",\"publisher\":{\"@id\":\"https://docs.cryptoquant.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cryptoquant.com/guides/authentication#webpage\",\"url\":\"https://docs.cryptoquant.com/guides/authentication\",\"name\":\"Authentication\",\"description\":\"Authenticate requests with a Bearer token or an api_key query parameter.\",\"dateModified\":\"2026-07-09T06:39:43.668Z\",\"isPartOf\":{\"@id\":\"https://docs.cryptoquant.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cryptoquant.com/guides/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cryptoquant.com/guides/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.cryptoquant.com/index\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.cryptoquant.com/guides/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cryptoquant.com/guides/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Authenticate requests with a Bearer token or an api_key query parameter.\",\"url\":\"https://docs.cryptoquant.com/guides/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cryptoquant.com/guides/authentication#webpage\"},\"dateModified\":\"2026-07-09T06:39:43.668Z\",\"publisher\":{\"@id\":\"https://docs.cryptoquant.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cryptoquant.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CryptoQuant API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"CryptoQuant API","nav":{"global":null,"tabs":[{"tab":"Get Started","groups":[{"group":"Getting Started","pages":[{"title":"CryptoQuant API","mode":"wide","href":""},{"title":"Quickstart","description":"Make your first CryptoQuant API call.","icon":"rocket","href":"/guides/quickstart"},{"title":"Authentication","icon":"key","href":"/guides/authentication"},{"title":"Vibe Quants","description":"Join Vibe Quants — CryptoQuant's community of builders turning on-chain ideas into research-grade indicators that ship straight into the API.","icon":"users","href":"/guides/vibe-quants"}]},{"group":"Concepts","pages":[{"title":"Plans \u0026 Limits","icon":"table-cells","href":"/guides/plans-and-limits"},{"title":"Time Convention","icon":"clock","href":"/guides/time-convention"},{"title":"Data Latency","icon":"gauge-high","href":"/guides/data-latency"},{"title":"Status \u0026 Error Codes","icon":"circle-check","href":"/guides/status-codes"},{"title":"API Credits","icon":"coins","href":"/guides/api-credits"},{"title":"On-Chain Metrics Glossary","icon":"book-open","href":"/guides/glossary"},{"title":"Frequently Asked Questions","icon":"circle-question","href":"/guides/faq"}]},{"group":"AI Tools","pages":[{"title":"For AI Agents","icon":"robot","href":"/guides/for-ai-agents"},{"title":"MCP Server","href":"/guides/mcp-server"},{"title":"Remote MCP (Recommended)","href":"/guides/mcp-remote"},{"title":"Local MCP Installation","href":"/guides/mcp-local"}]}]},{"tab":"API v1","pages":[{"title":"API v1","href":"/api-reference/available-endpoints/endpoints"}]},{"tab":"API v2","pages":[{"title":"API v2","href":"/v2/overview"}]},{"tab":"Indicator API","pages":[{"title":"Indicator API","href":"/indicator-api/overview"}]},{"tab":"Sentiment Data","pages":[{"title":"Sentiment Data","href":"/sentiment/overview"}]},{"tab":"Data Catalog","pages":[{"title":"Data Catalog","href":"/catalog/overview"}]},{"tab":"Data Guide","pages":[{"title":"Data Guide","href":"/data-guide/exchange"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/guides/changelog"}]}]},"title":"Authentication - CryptoQuant API","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":[],"chunks":[]}