---
title: "Get metric data for multiple projects"
method: GET
path: "/v2/metrics/{metric_id}"
tags: ["Metrics"]
---

# Get metric data for multiple projects

`GET /v2/metrics/{metric_id}`

## Request

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

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.

## Path parameters

- `metric_id` string, required

## Query parameters

- `project_ids` string[]
- `chain_ids` string[]
- `product_ids` string[]
- `market_sector_ids` string[]
- `start` string, date
- `end` string, date
- `assets_bridged` boolean

## Response `200`

OK

- object
  - `data` object[]
    - `timestamp` string: Returns the historical date for a given metric(s).
    - `project_id` string: Returns the project ID.
    - `project_name` string: Returns the project name used on the web application.
    - `metric_id` string: Returns the chosen metric for the project(s).
    - `value` string: Returns the value of the chosen metric.
  - `errors` union[]: 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.
    - union
      - object
        - `code` 'NOT_FOUND', required: Error code indicating the entity was not found
        - `field` 'project_ids' | 'metric_ids' | 'chain_ids' | 'product_ids' | 'market_sector_ids', required: The request parameter field that contained the invalid value
        - `value` string, required: The invalid ID value that was not found
      - object
        - `code` 'METRIC_NOT_AVAILABLE', required: Error code indicating the metric is not available for the specified project
        - `project_id` string, required: The project ID that does not have the metric available
        - `metric_id` string, required: The metric ID that is not available for the project

---

[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)