---
title: "Get historical metrics for an asset"
method: GET
path: "/v2/assets/{asset_id}/metrics"
tags: ["Assets"]
---

# Get historical metrics for an asset

`GET /v2/assets/{asset_id}/metrics`

## Request

- Base URL: `https://api.tokenterminal.com`
- URL: `https://api.tokenterminal.com/v2/assets/{asset_id}/metrics`
- Auth: HTTP bearer

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.

## Path parameters

- `asset_id` string, required

## Query parameters

- `metric_id` string
- `chain_ids` string[]
- `product_ids` string[]
- `start` string, date
- `end` string, date
- `aggregate_by` string[]
- `order_direction` 'asc' | 'desc'
- `interval` union
  - '24h' | '7d' | '30d' | '90d' | '180d' | '365d' | 'max' | 'ytd' | '4fullq'
  - integer

## Response `200`

OK

- object
  - `data` object[]
    - `timestamp` string: Returns the historical date for a given metric.
    - `asset_id` string: Returns the asset ID.
    - `metric_id` string: Returns the chosen metric for the asset.
    - `value` string: Returns the value of the chosen metric.

---

[API](https://skmtc.dev/tokenterminal/apis/token-terminal-api.md) - [All operations](https://skmtc.dev/tokenterminal/apis/token-terminal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tokenterminal/apis/token-terminal-api/revisions/35b0e064e128?raw)