> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworksresearch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Single Metric

> Retrieve a specific metric for specific projects

export const Endpoint = ({method, path}) => {
  return <div className={`px-[0.5em] py-[0.5em] border border-black/10 dark:border-white/10 rounded-2xl flex
    items-center gap-3 font-medium text-black/100 dark:text-white/90 whitespace-nowrap`}>
      <span className="text-green-600/100 bg-green-200/50 dark:text-green-400/100 dark:bg-green-400/10 px-3 py-1 rounded-lg text-md font-bold">
        {method}
      </span>
      <span className="text-sm md:text-base lg:text-lg overflow-hidden text-ellipsis whitespace-nowrap">
        {path}
      </span>
    </div>;
};

## Overview

The `GET /v1/metrics/{identifier}` endpoint returns a time series for a single metric across one or more projects.
Metrics are curated, aggregated datasets (usually daily) such as network revenue, token supply, or DEX volume.
Each metric has a stable identifier and consistent schema, with methodology documented in the [Metrics Catalog](/api-reference/metrics/catalog).

## Basic Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \\
    "https://api.blockworks.com/v1/metrics/rev-usd?project=ethereum"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    'https://api.blockworks.com/v1/metrics/rev-usd?project=ethereum',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  )
  const data = await response.json()
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.blockworks.com/v1/metrics/rev-usd',
      headers={'x-api-key': 'YOUR_API_KEY'},
      params={'project': 'ethereum'}
  )
  data = response.json()
  ```
</CodeGroup>

## Multiple Projects Example

If supported, request multiple projects in a single call by separating them with commas:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \\
  "https://api.blockworks.com/v1/metrics/rev-usd?project=ethereum,optimism,arbitrum"
```

## Response Structure

Returns a JSON object where each key is a project identifier, and its value is an array of date/value pairs.

Ethereum REV in USD example:

```json theme={null}
{
  "ethereum": [
    { "date": "2015-08-07", "value": 0 },
    { "date": "2015-08-08", "value": 0 },
    ...
    { "date": "2025-08-06", "value": 948090.6293758566 },
    { "date": "2025-08-07", "value": 1175055.4507596379 },
    { "date": "2025-08-08", "value": 1370617.1360337874 }
  ]
}
```

### Response Fields

| Field       | Type   | Description                                      |
| ----------- | ------ | ------------------------------------------------ |
| `<project>` | array  | Top-level key matching the project slug          |
| `date`      | string | ISO-8601 date for the data point                 |
| `value`     | number | Metric value for that date in the requested unit |

## Configuration

### Path Parameters

| Parameter    | Type   | Description       | Required |
| ------------ | ------ | ----------------- | -------- |
| `identifier` | string | Metric identifier | Yes      |

Use the `identifier` from the [List Metrics](/api-reference/metrics/list) endpoint to specify which metric to retrieve.

### Query Parameters

| Parameter    | Type   | Description               | Default     |
| ------------ | ------ | ------------------------- | ----------- |
| `project`    | string | Project identifier (slug) | Required    |
| `start_date` | string | Start date (YYYY-MM-DD)   | 30 days ago |
| `end_date`   | string | End date (YYYY-MM-DD)     | Today       |

For details on valid metric identifiers and project slugs, see [List Metrics](/api-reference/metrics/list) and [Projects Supported](/projects-supported).