List Metrics

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 available metrics and their metadata. Results include the metric name, description, stable identifier, supported chains/projects, data type, default interval, and source information. This is the best place to find the correct identifier to use with Get Single Metric.

Example Request

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

const res = await fetch('https://api.blockworks.com/v1/metrics', {
  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'}
)
data = r.json()

Example Response

A successful response returns a paginated list of metric definitions, with the following fields:

{
  "data": [
    {
      "name": "NAV (USD)",
      "description": "Dollar value of crypto assets (does not include cash)",
      "identifier": "treasury-nav-total-usd",
      "project": "CEP",
      "source": "Blockworks",
      "data_type": "timeseries_usd",
      "parameters": {
        "end_date": {
          "type": "date",
          "default": "3000-01-01",
          "description": "End date (inclusive)"
        },
        "start_date": {
          "type": "date",
          "default": "2000-01-01",
          "description": "Start date (inclusive)"
        }
      },
      "interval": "daily",
      "aggregation": "LAST",
      "category": "Treasury",
      "denomination": "USD",
      "updated_at": 1758867864
    }
    // ... 399 other metrics
  ],
  "total": 400,
  "page": 1
}

Supported Options

Parameter	Type	Description	Example
`project`	string	Filter by project/chain slug. Supports comma-separated list.	`project=ethereum,base`
`identifier`	string	Filter by exact metric identifier.	`identifier=rev-usd`
`limit`	integer	Page size.	`limit=100`
`page`	string	Page for pagination.	`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 other endpoints (e.g., `GET /v1/metrics/{identifier}`)
`project`	string	Chain/project slug this metric definition applies to
`source`	string	Data lineage owner (e.g., Blockworks)
`data_type`	string	Shape/units of the series (e.g., `timeseries_usd`, `timeseries_float`)
`parameters`	object	Supported query parameters for retrieving the 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?limit=100&page=1"

Introduction

Assets

Chart Data

Token Transparency

Market Stats

Metrics

Metrics: Chains

Metrics: Projects

Metrics: ETFs

Metrics: Treasuries

Overview

Example Request

Example Response

Supported Options

Response Fields

See also

Authorizations

Query Parameters

Response

​Overview

​Example Request

​Example Response

​Supported Options

​Response Fields

​Pagination

​See also

Authorizations

Query Parameters

Response

Overview

Example Request

Example Response

Supported Options

Response Fields

Pagination

See also