Skip to main content
GET
/
v2
/
metrics
/
{metric_id}
Get metric data for multiple projects
curl --request GET \
  --url https://api.tokenterminal.com/v2/metrics/{metric_id} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "timestamp": "<string>",
      "project_id": "<string>",
      "project_name": "<string>",
      "metric_id": "<string>",
      "value": "<string>"
    }
  ],
  "errors": [
    {
      "code": "NOT_FOUND",
      "field": "project_ids",
      "value": "invalid-project"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
metric_id
string
required

Allows you to select one of the metrics available. The full list is available on the metrics endpoint (see above).

Query Parameters

​
project_ids
string[]

Allows you to select one or more of the projects available for a specific metric. When including multiple projects, separate each one with a comma. Example: aave,uniswap.

You can fetch all available projects for the respective metric by omitting this parameter or using value all.

​
chain_ids
string[]

List of chains to include according to projects chain availability.

Allows you to select one or more of the chains available for a specific project. When including multiple chains, separate each one with a comma. Example: ethereum,base.

The full list of available chains can be retrieved from the projects/:project_id endpoint.

​
product_ids
string[]

List of products to include according to projects product availability.

Allows you to select one or more of the products available for a specific project. When including multiple products, separate each one with a comma. Example: usdc,usdt.

The full list of available products can be retrieved from the projects endpoint.

​
market_sector_ids
string[]

List of market sector IDs to filter projects by.

Allows you to select one or more market sectors to filter the results. Only projects belonging to any of the specified market sectors will be included. When including multiple market sectors, separate each one with a comma. Example: blockchains-l1,lending.

The full list of available market sectors can be retrieved from the /v2/market-sectors endpoint.

​
start
string<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(s).

​
end
string<date>

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(s).

Response

200 - application/json

OK

​
data
object[]
​
errors
object[]

Optional array of errors that occurred during request processing. Only present if some requested entities were invalid or unavailable.

The endpoint returns data for valid entities even when errors are present, allowing partial success.

Example:
{
  "code": "NOT_FOUND",
  "field": "project_ids",
  "value": "invalid-project"
}