Use this endpoint to retrieve historical data for an asset.
This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an errors array with details about the invalid ones.
List of chains to include according to asset chain availability.
Allows you to select one or more of the chains available for a specific asset. When including multiple chains, separate each one with a comma. Example: ethereum,base.
List of products to include according to asset product availability.
Allows you to select one or more of the products available for a specific asset. When including multiple products, separate each one with a comma. Example: usdc,usdt.
Start date
Allows you to select the start date for the query. If no start is selected, the query defaults to launch date or the first date for which there is data available for the chosen metric.
Allows you to select the end date for the query. If no end is selected, the query defaults to the latest date for which there is data available for the chosen metric.
Allows you to define how the response is sorted. The response is always sorted by timestamp, and by selecting desc the response starts from the most recent entry, and vice versa for asc.
If no order_direction is selected, the response defaults to desc.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Token Terminal Docs","colors":{"primary":"#059669","light":"#34d399","dark":"#06b6d4"},"logo":{"light":"https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max\u0026auto=format\u0026n=ePVzUc4Jyl2mhQdQ\u0026q=85\u0026s=de49e0137894962aef5d37455c76ecf1","dark":"https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max\u0026auto=format\u0026n=ePVzUc4Jyl2mhQdQ\u0026q=85\u0026s=6a5317263edae34558e014343002fe93"},"favicon":"https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/favicon.ico?fit=max\u0026auto=format\u0026n=ePVzUc4Jyl2mhQdQ\u0026q=85\u0026s=2a27a950eff61d5db04838f2c5d18b49","navbar":{"primary":{"type":"button","label":"Talk to us","href":"https://tokenterminal.com/contact"}},"footer":{"socials":{"x":"https://x.com/tokenterminal","github":"https://github.com/token-terminal","linkedin":"https://www.linkedin.com/company/token-terminal"}},"fonts":{"family":"Geist"},"contextual":{"options":["claude","chatgpt","copy"],"display":"header"},"markdown":{"instructions":["To query the Token Terminal data catalog, read https://tokenterminal.com/docs/catalog/agents-manual.md first. It is the whole catalog as one page: table naming grammar, key columns, partition and cluster rules, units, additivity, and the tables that are documented but not served yet.","Never query a catalog table on a time bound alone. Also filter its cluster key, which you read from INFORMATION_SCHEMA.COLUMNS; an empty result means the object is a view, whose pruning contract is on its page. Compute is billed to the caller's own Google Cloud project."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tokenterminal","hasAudioNarration":false,"actualSubdomain":"tokenterminal","customDomains":["tokenterminal.com"],"gitSource":{"type":"github","owner":"token-terminal","repo":"tt-analytics","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae1ea7a6693c0e39e472725","collectionId":"b4217ee4-0dc0-4dda-9c7a-bd20aa0e057e","liveDeploymentHistoryId":"6ae1ea7a6693c0e39e472725","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae1ea7a6693c0e39e472725","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"Data catalog","count":619},{"language":"default","tag":"Chain ecosystems","count":524},{"language":"default","tag":"EVM ecosystem","count":469},{"language":"default","tag":"Core entities","count":43},{"language":"default","tag":"Market verticals","count":37},{"language":"default","tag":"Overview","count":28},{"language":"default","tag":"API","count":24},{"language":"default","tag":"Endpoints","count":22},{"language":"default","tag":"MCP","count":20},{"language":"default","tag":"Assets","count":16}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"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":"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}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".tt-check,.tt-cross{color:#059669;font-weight:600}.tt-cross{color:#dc2626}html.dark .tt-check{color:#30d9a2}html.dark .tt-cross{color:#f87171}.tt-na{color:#9ca3af}html.dark .tt-denom,html.dark .tt-na{color:#6b7280}.tt-denom,.tt-meter{font-variant-numeric:tabular-nums}.tt-denom{font-weight:400;color:#9ca3af}.tt-meter{display:flex;justify-content:space-between;align-items:baseline;margin-top:1rem;font-size:.8125rem;color:#6b7280}.tt-meter span:last-child{font-weight:600;color:#374151}html.dark .tt-meter{color:#9ca3af}html.dark .tt-meter span:last-child{color:#e5e7eb}.tt-bar{height:6px;margin-top:.375rem;border-radius:999px;background:#e5e7eb;overflow:hidden}.tt-bar>div{height:100%;border-radius:999px;background:#52525b}html.dark .tt-bar{background:#27272a}html.dark .tt-bar>div{background:#a1a1aa}.tt-coverage td+td,.tt-stat{font-variant-numeric:tabular-nums}.tt-stat{margin-top:1rem;font-size:1.75rem;font-weight:600;line-height:1}.tt-coverage td+td{text-align:right}.tt-coverage th+th{text-align:right}.tt-coverage{font-size:.8125rem;line-height:1.35;width:auto;max-width:100%}.tt-coverage td,.tt-coverage th{padding:.3125rem .5rem;white-space:nowrap}.tt-coverage thead th{vertical-align:bottom;font-size:.75rem}.tt-coverage .tt-denom{display:block;font-size:.6875rem}.tt-coverage td:first-child,.tt-coverage th:first-child{text-align:left}.tt-coverage .tt-left{text-align:left;white-space:nowrap}.tt-scroll,table{overflow-x:auto}.tt-chips code,table code{white-space:nowrap}table td:last-child,table th:last-child{min-width:20rem}.tt-coverage .tt-spacer{width:100%;padding:0;border:0}.tt-coverage td:last-child,.tt-coverage th:last-child{min-width:0}.tt-coverage .tt-flex{width:100%;white-space:normal;text-align:left}.tt-coverage td:first-child,.tt-coverage th:first-child{min-width:8rem}.tt-roster{--tt-roster-bg:#fff;max-height:26rem;overflow-y:auto;background:linear-gradient(var(--tt-roster-bg) 30%,rgba(255,255,255,0)) top/100% 2.5rem no-repeat local,linear-gradient(rgba(255,255,255,0),var(--tt-roster-bg) 70%) bottom/100% 2.5rem no-repeat local,radial-gradient(farthest-side at 50% 0,rgba(0,0,0,.22),transparent) top/100% .75rem no-repeat,radial-gradient(farthest-side at 50% 100%,rgba(0,0,0,.22),transparent) bottom/100% .75rem no-repeat;scrollbar-width:thin}.tt-roster table,.tt-roster tbody,.tt-roster tr{background:0 0}.tt-roster::-webkit-scrollbar{width:8px}.tt-roster::-webkit-scrollbar-thumb{border-radius:4px;background:rgba(128,128,128,.45)}.tt-roster thead th{position:sticky;top:0;z-index:1;background:var(--tt-roster-bg)}:root[data-theme=dark] .tt-roster,html.dark .tt-roster{--tt-roster-bg:#0a0a0a;background:linear-gradient(var(--tt-roster-bg) 30%,rgba(10,10,10,0)) top/100% 2.5rem no-repeat local,linear-gradient(rgba(10,10,10,0),var(--tt-roster-bg) 70%) bottom/100% 2.5rem no-repeat local,radial-gradient(farthest-side at 50% 0,rgba(255,255,255,.16),rgba(255,255,255,0)) top/100% .75rem no-repeat,radial-gradient(farthest-side at 50% 100%,rgba(255,255,255,.16),rgba(255,255,255,0)) bottom/100% .75rem no-repeat}.tt-chips{display:flex;flex-wrap:wrap;gap:.375rem;padding:.125rem}"}],"page":{"pagePath":"api-reference/assets/get-historical-metrics-for-an-asset","slug":"/api-reference/assets/get-historical-metrics-for-an-asset","pageMetadata":{"title":"Get historical metrics for an asset","description":"Use this endpoint to retrieve historical data for an asset.\n\nThis endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an `errors` array with details about the invalid ones.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/assets/{asset_id}/metrics","href":"/api-reference/assets/get-historical-metrics-for-an-asset","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Use this endpoint to retrieve historical data for an asset.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an \", _jsx(_components.code, {\n children: \"errors\"\n }), \" array with details about the invalid ones.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get historical metrics for an asset","description":"Use this endpoint to retrieve historical data for an asset.\n\nThis endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an `errors` array with details about the invalid ones.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/assets/{asset_id}/metrics","href":"/api-reference/assets/get-historical-metrics-for-an-asset","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tokenterminal/b26269b087332649/scripts/getMarketingData.js","/docs/_mintlify/custom/tokenterminal/0fd641a8cd5adda1/scripts/generateQueriesDocs.js","/docs/_mintlify/custom/tokenterminal/8dc1ab8bc33d0739/scripts/templates/datasetPage.template.js","/docs/_mintlify/custom/tokenterminal/45fa7161e2167527/snippets/queries-overrides/tt-blockchain/bitcoin.js","/docs/_mintlify/custom/tokenterminal/73d65fc07dce97ce/bq-project.js"],"openApiReferenceData":{"operation":{"tags":["Assets"],"summary":"Get historical metrics for an asset","description":"Use this endpoint to retrieve historical data for an asset.\n\nThis endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an `errors` array with details about the invalid ones.\n","parameters":["bf37fb71-075e-4768-97e5-7ed0c718fa89","895bb8ed-92bf-49a1-8f29-7a9fa580e22a","67ce600a-91db-4017-9c2f-5f750183e45d","9c3e3549-a3cf-484a-9f7d-9c85b8151aa4","f9bf98c0-ab37-4b3f-acfa-94a781171e6f","83bd2178-3e56-4442-9696-d608fe5feee0","1e1f0bc9-b8b5-4ee5-950c-86f8c22ed7c9","f0495ef8-0adb-442b-8486-e24d5c9f5b6d","74ae43fd-9e8b-4997-b3be-7a1236aeaca2"],"responses":{"200":"198cc120-5f34-4e2b-9070-f8c9bec35f0d"},"method":"get","type":"path","servers":["c4d173ed-011a-4b2a-82bd-4ecd5044cec0"],"security":["2b37da73-b46a-4735-b628-0fe3e9489954"],"path":"/v2/assets/{asset_id}/metrics","baseUrlOptions":["https://api.tokenterminal.com"],"title":"Get historical metrics for an asset","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"bf37fb71-075e-4768-97e5-7ed0c718fa89":{"name":"asset_id","in":"path","description":"ID of the asset\n\nAllows you to select one of the assets available.\n\nThe full list is available on the assets endpoint (see above).\n","required":true,"schema":{"type":"string","isRequired":true,"description":"ID of the asset\n\nAllows you to select one of the assets available.\n\nThe full list is available on the assets endpoint (see above).\n","uniqueKey":"","typeLabel":"string"}},"895bb8ed-92bf-49a1-8f29-7a9fa580e22a":{"name":"metric_id","in":"query","description":"Metric to include according to asset metric availability.\n\nAllows you to select one of the metrics available for a specific asset.\n\nIf no metric_id is selected, the query defaults to `asset_price`.\n","schema":{"type":"string","description":"Metric to include according to asset metric availability.\n\nAllows you to select one of the metrics available for a specific asset.\n\nIf no metric_id is selected, the query defaults to `asset_price`.\n","uniqueKey":"","typeLabel":"string"},"example":"asset_price"},"67ce600a-91db-4017-9c2f-5f750183e45d":{"name":"chain_ids","in":"query","description":"List of chains to include according to asset chain availability.\n\nAllows you to select one or more of the chains available for a specific asset. When including multiple chains, separate each one with a comma. Example: `ethereum,base`.\n","explode":false,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"description":"List of chains to include according to asset chain availability.\n\nAllows you to select one or more of the chains available for a specific asset. When including multiple chains, separate each one with a comma. Example: `ethereum,base`.\n","uniqueKey":"","typeLabel":"string[]"},"example":["ethereum","base"]},"9c3e3549-a3cf-484a-9f7d-9c85b8151aa4":{"name":"product_ids","in":"query","description":"List of products to include according to asset product availability.\n\nAllows you to select one or more of the products available for a specific asset. When including multiple products, separate each one with a comma. Example: `usdc,usdt`.\n","explode":false,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"description":"List of products to include according to asset product availability.\n\nAllows you to select one or more of the products available for a specific asset. When including multiple products, separate each one with a comma. Example: `usdc,usdt`.\n","uniqueKey":"","typeLabel":"string[]"},"example":["usdc","usdt"]},"f9bf98c0-ab37-4b3f-acfa-94a781171e6f":{"name":"start","in":"query","schema":{"type":"string","format":"date","description":"Start date\nAllows you to select the start date for the query. If no start is selected, the query defaults to launch date or the first date for which there is data available for the chosen metric.\n","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"Start date\nAllows you to select the start date for the query. If no start is selected, the query defaults to launch date or the first date for which there is data available for the chosen metric.\n"},"83bd2178-3e56-4442-9696-d608fe5feee0":{"name":"end","in":"query","schema":{"type":"string","format":"date","description":"End date\n\nAllows you to select the end date for the query. If no end is selected, the query defaults to the latest date for which there is data available for the chosen metric.\n","uniqueKey":"","typeLabel":"string\u003cdate>"},"description":"End date\n\nAllows you to select the end date for the query. If no end is selected, the query defaults to the latest date for which there is data available for the chosen metric.\n"},"1e1f0bc9-b8b5-4ee5-950c-86f8c22ed7c9":{"name":"aggregate_by","in":"query","description":"Level of granularity\n\nThis feature enables more detailed queries of specific metrics. For instance, you can examine an asset's metrics by individual chain.\n\nHowever, it's important to note that this level of granularity is not applicable to all metrics.\n\nThe only supported value is `chain`.\n","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["chain"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Level of granularity\n\nThis feature enables more detailed queries of specific metrics. For instance, you can examine an asset's metrics by individual chain.\n\nHowever, it's important to note that this level of granularity is not applicable to all metrics.\n\nThe only supported value is `chain`.\n","uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"example":["chain"]},"f0495ef8-0adb-442b-8486-e24d5c9f5b6d":{"name":"order_direction","description":"Timestamp ordering\n\nAllows you to define how the response is sorted. The response is always sorted by timestamp, and by selecting `desc` the response starts from the most recent entry, and vice versa for `asc`.\n\nIf no order_direction is selected, the response defaults to `desc`.\n","in":"query","schema":{"type":"string","default":"desc","enum":["asc","desc"],"description":"Timestamp ordering\n\nAllows you to define how the response is sorted. The response is always sorted by timestamp, and by selecting `desc` the response starts from the most recent entry, and vice versa for `asc`.\n\nIf no order_direction is selected, the response defaults to `desc`.\n","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"74ae43fd-9e8b-4997-b3be-7a1236aeaca2":{"name":"interval","in":"query","description":"Time interval for data aggregation.\n\nIntervals are `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max`, `ytd`, `4fullq`, or a number representing days.\n","schema":{"oneOf":[{"type":"string","enum":["24h","7d","30d","90d","180d","365d","max","ytd","4fullq"],"description":"Time interval for data aggregation.\n\nIntervals are `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max`, `ytd`, `4fullq`, or a number representing days.\n","uniqueKey":"oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"integer","description":"Time interval for data aggregation.\n\nIntervals are `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max`, `ytd`, `4fullq`, or a number representing days.\n","uniqueKey":"oneOf.1","typeLabel":"integer"}],"uniqueKey":"","typeLabel":"enum\u003cstring> | integer"}}},"responses":{"198cc120-5f34-4e2b-9070-f8c9bec35f0d":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","description":"Returns the historical date for a given metric.","uniqueKey":"data.items.[INDEX].timestamp","typeLabel":"string"},"asset_id":{"type":"string","description":"Returns the asset ID.","uniqueKey":"data.items.[INDEX].asset_id","typeLabel":"string"},"metric_id":{"type":"string","description":"Returns the chosen metric for the asset.","uniqueKey":"data.items.[INDEX].metric_id","typeLabel":"string"},"value":{"type":"string","description":"Returns the value of the chosen metric.","uniqueKey":"data.items.[INDEX].value","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"timestamp":"\u003cstring>","asset_id":"\u003cstring>","metric_id":"\u003cstring>","value":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2b37da73-b46a-4735-b628-0fe3e9489954":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"string","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"c4d173ed-011a-4b2a-82bd-4ecd5044cec0":{"url":"https://api.tokenterminal.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"string","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"tokenterminal","siteName":"Token Terminal Docs","title":"Get historical metrics for an asset - Token Terminal Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T08:44:30.414Z","originalFileLocation":"api-reference/assets/get-historical-metrics-for-an-asset.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=\"Use this endpoint to retrieve historical data for an asset. This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an errors array with details about the invalid ones.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Token Terminal Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_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=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get historical metrics for an asset - Token Terminal Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use this endpoint to retrieve historical data for an asset. This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an errors array with details about the invalid ones.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Token Terminal Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tokenterminal.mintlify.app/_mintlify/api/og/v2?division=Assets\u0026amp;title=Get+historical+metrics+for+an+asset\u0026amp;description=Use+this+endpoint+to+retrieve+historical+data+for+an+asset.%0A%0AThis+endpoint+supports+partial+success+-+if+some+of+the+requested+metric%2C+chain%2C+or+product+IDs+are\u0026amp;theme=40be3779f1afe06352960330\u0026amp;signature=2e407184eb9a432dce06e059fa6a5a5260af9ecb19808fd6b07140025715dfca\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get historical metrics for an asset - Token Terminal Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use this endpoint to retrieve historical data for an asset. This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an errors array with details about the invalid ones.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tokenterminal.mintlify.app/_mintlify/api/og/v2?division=Assets\u0026amp;title=Get+historical+metrics+for+an+asset\u0026amp;description=Use+this+endpoint+to+retrieve+historical+data+for+an+asset.%0A%0AThis+endpoint+supports+partial+success+-+if+some+of+the+requested+metric%2C+chain%2C+or+product+IDs+are\u0026amp;theme=40be3779f1afe06352960330\u0026amp;signature=2e407184eb9a432dce06e059fa6a5a5260af9ecb19808fd6b07140025715dfca\">\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=\"/docs/mintlify-assets/_mintlify/favicons/tokenterminal/JF6-BD5LBr5nGf_K/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Token Terminal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#059669\">\u003clink data-mint-head rel=\"canonical\" href=\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/assets/get-historical-metrics-for-an-asset.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://tokenterminal.com/#organization\",\"name\":\"Token Terminal Docs\",\"url\":\"https://tokenterminal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max\u0026auto=format\u0026n=ePVzUc4Jyl2mhQdQ\u0026q=85\u0026s=de49e0137894962aef5d37455c76ecf1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://tokenterminal.com/docs#website\",\"name\":\"Token Terminal Docs\",\"url\":\"https://tokenterminal.com/docs\",\"publisher\":{\"@id\":\"https://tokenterminal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#webpage\",\"url\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset\",\"name\":\"Get historical metrics for an asset\",\"description\":\"Use this endpoint to retrieve historical data for an asset. This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an errors array with details about the invalid ones.\",\"dateModified\":\"2026-10-28T08:44:30.414Z\",\"isPartOf\":{\"@id\":\"https://tokenterminal.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Assets\",\"item\":\"https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get historical metrics for an asset\",\"item\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#apireference\",\"headline\":\"Get historical metrics for an asset\",\"name\":\"Get historical metrics for an asset\",\"description\":\"Use this endpoint to retrieve historical data for an asset. This endpoint supports partial success - if some of the requested metric, chain, or product IDs are not found, the endpoint will return data for the valid entities and include an errors array with details about the invalid ones.\",\"url\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset\",\"mainEntityOfPage\":{\"@id\":\"https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#webpage\"},\"dateModified\":\"2026-10-28T08:44:30.414Z\",\"publisher\":{\"@id\":\"https://tokenterminal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://tokenterminal.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Token Terminal Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Token Terminal Docs","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"Data catalog","pages":[{"title":"Data catalog","href":"/catalog"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/introduction"}]},{"tab":"API","groups":[{"group":"Overview","pages":[{"title":"Introduction","icon":"book-open","href":"/api-reference/introduction"},{"title":"Best practices","icon":"toolbox","href":"/api-reference/best-practices"}]},{"group":"Endpoints","pages":[{"group":"Projects","pages":[{"title":"Get a list of all projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects","href":"/api-reference/projects/get-a-list-of-all-projects"},{"title":"Get historical metrics for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects/{project_id}/metrics","href":"/api-reference/projects/get-historical-metrics-for-a-project"},{"title":"Get metric availability for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects/{project_id}","href":"/api-reference/projects/get-metric-availability-for-a-project"},{"title":"Get metric aggregations for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects/{project_id}/metric-aggregations","href":"/api-reference/projects/get-metric-aggregations-for-a-project"},{"title":"Get financial statement for a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects/{project_id}/financial-statement","href":"/api-reference/projects/get-financial-statement-for-a-project"},{"title":"Get details for a specific product of a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects/{project_id}/products/{product_id}","href":"/api-reference/projects/get-details-for-a-specific-product-of-a-project"},{"title":"Get historical metrics for a specific product of a project","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/projects/{project_id}/products/{product_id}/metrics","href":"/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project"}]},{"group":"Market sectors","pages":[{"title":"Get a list of all market sectors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/market-sectors","href":"/api-reference/market-sectors/get-a-list-of-all-market-sectors"},{"title":"Get market sector data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/market-sectors/{market_sector_id}","href":"/api-reference/market-sectors/get-market-sector-data"}]},{"group":"Metrics","pages":[{"title":"Get a list of all metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/metrics","href":"/api-reference/metrics/get-a-list-of-all-metrics"},{"title":"Get metric data for multiple projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/metrics/{metric_id}","href":"/api-reference/metrics/get-metric-data-for-multiple-projects"},{"title":"Get metric aggregations for multiple projects","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/metric-aggregations","href":"/api-reference/metrics/get-metric-aggregations-for-multiple-projects"},{"title":"Get metric breakdown aggregation for multiple projects, chains, or products","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/metric-breakdown","href":"/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products"}]},{"group":"Assets","pages":[{"title":"Get a list of all assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/assets","href":"/api-reference/assets/get-a-list-of-all-assets"},{"title":"Get asset details and available metrics","description":"Use this endpoint to retrieve detailed information about a specific asset, including the list of available metrics.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/assets/{asset_id}","href":"/api-reference/assets/get-asset-details-and-available-metrics"},{"title":"Get historical metrics for an asset","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/assets/{asset_id}/metrics","href":"/api-reference/assets/get-historical-metrics-for-an-asset"},{"title":"Get asset metrics breakdown","description":"Use this endpoint to retrieve aggregated breakdown data for asset metrics across different dimensions (projects, chains, market sectors, etc.).\n\nIf an empty `metric_ids` array is provided, it defaults to `['asset_price']`.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v2/assets/{asset_id}/metrics-breakdown","href":"/api-reference/assets/get-asset-metrics-breakdown"},{"title":"Get a list of all reference assets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/reference-assets","href":"/api-reference/assets/get-a-list-of-all-reference-assets"},{"title":"Get reference asset details","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/reference-assets/{reference_asset_id}","href":"/api-reference/assets/get-reference-asset-details"},{"title":"Get an asset fact sheet","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/assets/{asset_id}/fact-sheet","href":"/api-reference/assets/get-an-asset-fact-sheet"},{"title":"Get asset fact sheets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/fact-sheets","href":"/api-reference/assets/get-asset-fact-sheets"},{"title":"Get fact sheet field definitions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v2/fact-sheets/fields","href":"/api-reference/assets/get-fact-sheet-field-definitions"}]}]}]}]},"title":"Get historical metrics for an asset - Token Terminal Docs","buildId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","deploymentId":"dpl_DGmhKsAzJdVqypJzon18vViniWRY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-2jF_ccbi.js","utils-NNMVb_sb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DdtBhtt6.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D1OxL5O8.js","snippetPresets-DDC-KAXp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BOnTqOyQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-EEWI6FIO.js","shallow-fGZcWzm2.js","getApiPlaygroundDisplay-B3B8qEvw.js","CodeSnippet-BG9nsSU4.js","CodeSnippets-BlRACLKl.js","Page-FtoC8lZ9.js","getPastedJson-COV-Kgnr.js","icon-BXu3lasn.js","MethodPill-DGMUqJKh.js","DuplicateIcon-JEUJDHz_.js","createIcon-BDFucJ34.js","DynamicMarkdown-34OtG_BH.js","SectionHeading-tBbRD59j.js","axios-vUo_bRtp.js","Markdown-SoRz2nk2.js","clsx-BOmkPVIU.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DN0dCbTw.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BcsLYcfW.js"]}