Get Single Metric

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.

Basic Example

curl -H "x-api-key: YOUR_API_KEY" \\
  "https://api.blockworks.com/v1/metrics/rev-usd?project=ethereum"

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

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

Multiple Projects Example

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

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:

{
  "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 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 and Projects Supported.

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

Overview

Basic Example

Multiple Projects Example

Response Structure

Response Fields

Configuration

Path Parameters

Query Parameters

​Overview

​Basic Example

​Multiple Projects Example

​Response Structure

​Response Fields

​Configuration

​Path Parameters

​Query Parameters

Overview

Basic Example

Multiple Projects Example

Response Structure

Response Fields

Configuration

Path Parameters

Query Parameters