Skip to main content

​
Overview

Metrics in the Blockworks API are curated, time-series datasets that track key blockchain network statistics like revenue, token supply, or DEX volume. Each metric provides historical data across multiple blockchain projects with consistent methodology and formatting.
TopicDetails
What is a metric?Curated time-series data (usually daily) for blockchain networks
What is a project?An asset from the assets collection - each represents a blockchain or protocol
Data structureJSON object keyed by project identifier, containing date/value arrays
CoverageComplete daily historical data available for each supported project

​
Projects and Assets

In the context of metrics, a “project” refers to an asset from the assets collection. When you request metrics data, you specify projects using their asset slugs (like ethereum, bitcoin, solana).

​
Payload Structure

The response is a JSON object with the following structure: 
{
  [project_slug1]: [
    { "date": "2015-08-07", "value": 56324 },
    { "date": "2015-08-08", "value": 123456 },
    { "date": "2025-08-07", "value": 1175055.45 },
    // ...
    { "date": "2025-08-13", "value": 1175055.45 }
  ],
  [project_slug2]: [
    { "date": "2015-08-07", "value": 56324 },
    { "date": "2015-08-08", "value": 123456 },
    { "date": "2025-08-07", "value": 1175055.45 },
    // ...
    { "date": "2025-08-13", "value": 1175055.45 }
  ]
}
Each project’s data is an array of objects with two fields:
FieldTypeDescription
datestringISO-8601 date (YYYY-MM-DD)
valuenumberMetric value for that date in the specified unit

​
Single Project

To request data for a single project, use the project query parameter with the project slug.
cURL
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/metrics/rev-usd?project=ethereum"
When requesting data for one project, the response contains a single key-value pair: 
{
  "ethereum": [
    { "date": "2015-08-07", "value": 0 },
    { "date": "2015-08-08", "value": 0 },
    { "date": "2025-08-07", "value": 1175055.45 }
  ]
}

​
Multiple Projects

To request data for multiple projects, use the project query parameter with a comma-separated list of project slugs.
cURL
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/metrics/rev-usd?project=ethereum,arbitrum,optimism"
When requesting multiple projects, each project gets its own key in the response:
Response
{
  "ethereum": [
    { "date": "2015-08-07", "value": 0 },
    { "date": "2025-08-07", "value": 1175055.45 }
  ],
  "arbitrum": [
    { "date": "2021-05-28", "value": 0 },
    { "date": "2025-08-07", "value": 45230.12 }
  ],
  "optimism": [
    { "date": "2021-11-11", "value": 0 },
    { "date": "2025-08-07", "value": 23450.67 }
  ]
}

​
Historical Coverage

Each metric provides the complete historical dataset for every supported project:
  • Full history: Data starts from the project’s earliest available date
  • Consistent methodology: Same calculation method across all projects and time periods
  • Daily granularity: Most metrics provide daily data points
  • Up-to-date: Data is regularly updated with the latest values

​
Available Metrics

See the Metrics Catalog for a complete list of available metrics.