List Metrics by Project

GET

metrics

List Metrics

curl --request GET \
  --url https://api.blockworks.com/v1/metrics \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.blockworks.com/v1/metrics"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.blockworks.com/v1/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "page": 1073741824,
  "total": 50,
  "data": [
    {
      "name": "<string>",
      "description": "<string>",
      "identifier": "rev",
      "project": "Bitcoin",
      "source": "Blockworks",
      "data_type": "float",
      "parameters": {
        "end_date": {
          "type": "date",
          "required": false,
          "description": "End date (inclusive)"
        },
        "start_date": {
          "type": "date",
          "required": false,
          "description": "Start date (inclusive)"
        }
      },
      "updated_at": 123,
      "interval": "daily",
      "aggregation": "SUM",
      "category": "Financials",
      "denomination": "USD"
    }
  ]
}

Overview

Use this endpoint to discover every metric available for a single project/chain by applying the project query parameter. The response includes the metric name, description, stable identifier (used with Get Single Metric), data type, and data lineage source.

Quick summary

What	Details
Purpose	Discover metrics for a specific project/chain
How to filter	Add `?project={project}` to the request URL
Best next step	Copy the `identifier`, then query the series via `GET /v1/metrics/{identifier}`
Typical filters	`identifier`, `limit`, `page`
Pagination	Page-based via `limit` and `page`

Basic Example

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

const res = await fetch('https://api.blockworks.com/v1/metrics?project=ethereum', {
  headers: { 'x-api-key': 'YOUR_API_KEY' }
})
const data = await res.json()

import requests
r = requests.get(
  'https://api.blockworks.com/v1/metrics',
  headers={'x-api-key': 'YOUR_API_KEY'},
  params={'project': 'ethereum'}
)
data = r.json()

Filtering

Use query parameters to further narrow results for the chosen project:

Parameter	Type	Description	Example
`project`	string	Chain/project slug	`project=ethereum`
`identifier`	string	Filter by exact metric identifier	`identifier=rev-usd`
`limit`	integer	Page size	`limit=100`
`page`	string	Page for pagination	`page=1`

Response Structure

A successful response returns a paginated list of metric definitions for the specified project.

{
  "data": [
    {
      "name": "Native Token Price",
      "description": "The average token price during the specified time period for the native asset of that chain.",
      "identifier": "native-token-price",
      "project": "ethereum",
      "source": "Blockworks",
      "interval": "daily",
      "data_type": "timeseries_usd",
      "parameters": {
        "start_date": { "type": "date", "default": "2000-01-01", "description": "Start date (inclusive)" },
        "end_date": { "type": "date", "default": "3000-01-01", "description": "End date (inclusive)" }
      },
      "aggregation": "LAST",
      "category": "Financials",
      "denomination": "USD",
      "updated_at": 1758867864
    }
  ],
  "total": 25,
  "page": 1
}

Response Fields

Field	Type	Description
`name`	string	Human-readable metric name
`description`	string	What the metric measures and how it’s intended to be used
`identifier`	string	Stable key used with `GET /v1/metrics/{identifier}`
`project`	string	Chain/project slug (e.g., `ethereum`, `base`)
`source`	string	Data lineage owner (e.g., Blockworks)
`data_type`	string	Series shape and units (e.g., `timeseries_usd`, `timeseries_float`)
`parameters`	object	Supported query parameters when fetching this series
`interval`	string	Data frequency (e.g., `daily`)
`aggregation`	string	How values are aggregated (e.g., `SUM`, `LAST`)
`category`	string	Metric classification (e.g., `Financials`, `Treasury`)
`denomination`	string	Currency/unit designation (e.g., `USD`, `ETH`)
`updated_at`	integer	Unix timestamp of last update

Pagination

This endpoint uses page-based pagination. Pass limit to set page size and page to fetch the next page.

curl -H "x-api-key: YOUR_API_KEY" \\
  "https://api.blockworks.com/v1/metrics?project=ethereum&limit=100&page=1"

Error Example

If the specified project has no metrics, the response will return an empty list:

{
    "data": [],
    "total": 0,
    "page": 1
}

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

Overview

Quick summary

Basic Example

Filtering

Response Structure

Response Fields

Error Example

See also

Authorizations

Query Parameters

Response

​Overview

​Quick summary

​Basic Example

​Filtering

​Response Structure

​Response Fields

​Pagination

​Error Example

​See also

Authorizations

Query Parameters

Response

Overview

Quick summary

Basic Example

Filtering

Response Structure

Response Fields

Pagination

Error Example

See also