Skip to main content
GET
/
v1
/
metrics
List Metrics
curl --request GET \
  --url https://api.blockworks.com/v1/metrics \
  --header 'x-api-key: <api-key>'
{
  "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"

​
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

ParameterTypeDescriptionExample
projectstringFilter by project/chain slug. Supports comma-separated list.project=ethereum,base
identifierstringFilter by exact metric identifier.identifier=rev-usd
limitintegerPage size.limit=100
pagestringPage for pagination.page=1

​
Response Fields

FieldTypeDescription
namestringHuman-readable metric name
descriptionstringWhat the metric measures and how it’s intended to be used
identifierstringStable key used with other endpoints (e.g., GET /v1/metrics/{identifier})
projectstringChain/project slug this metric definition applies to
sourcestringData lineage owner (e.g., Blockworks)
data_typestringShape/units of the series (e.g., timeseries_usd, timeseries_float)
parametersobjectSupported query parameters for retrieving the series
intervalstringData frequency (e.g., daily)
aggregationstringHow values are aggregated (e.g., SUM, LAST)
categorystringMetric classification (e.g., Financials, Treasury)
denominationstringCurrency/unit designation (e.g., USD, ETH)
updated_atintegerUnix 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"

​
See also

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
page
integer
default:1
Required range: 1 <= x <= 2147483647
​
limit
integer
default:100
Required range: 1 <= x <= 100
​
project
string[]
Example:

"Bitcoin,Ethereum"

​
identifier
string[]
Example:

"txns,issuance"

Response

​
page
integer
required
Required range: 1 <= x <= 2147483647
​
total
integer
required
Required range: 1 <= x <= 100
​
data
object[]
required