TOtokenterminal
Metrics

Get metric data for multiple projects

Use this endpoint to retrieve metric data for multiple projects.

You can get specific metric for all projects by omitting project_ids or using project_ids=all.

This endpoint supports partial success - if some of the requested entities (projects, chains, or products) are invalid or if a metric is not available for a specific project, the endpoint will return data for the valid entities and include an errors array with details about the issues.

get/v2/metrics/{metric_id}

Request

  • Base URL
    https://api.tokenterminal.com
  • Auth
    HTTP bearer

Path parameters

metric_idstring required

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

Query parameters

project_idsstring[]

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_idsstring[]

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_idsstring[]

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_idsstring[]

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.

startstring 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).

endstring 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).

assets_bridgedboolean

Include bridged assets in asset metrics

Controls whether bridged asset values are included when calculating asset-related metrics (e.g. asset_market_cap_circulating, asset_transfer_volume). Set to false to exclude bridged assets and only count native asset values.

Defaults to true.

Response

OK

Example response

{
  "errors": [
    {
      "code": "NOT_FOUND",
      "field": "project_ids",
      "value": "invalid-project"
    }
  ]
}

Changes

No recorded changes to this operation across all 8 revisions of this API.