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"
    }
  ]
}

​
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": "Issuance",
      "description": "Newly issued tokens that are distributed to participants (such as validators, miners, or stakers) as compensation for participating in consensus.",
      "identifier": "issuance",
      "project": "ethereum",
      "source": "Blockworks",
      "data_type": "timeseries_float",
      "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": "SUM",
      "category": "Financials",
      "updated_at": 1755151418
    },
    // ... 99 other metrics
  ],
  "total": 114,
  "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

​
Field reference

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)
categorystringMetric classification (e.g., Financials)
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"

​
Error Example

{
  "error": {
    "type": "validation_error",
    "message": "Unsupported filter 'interval=hourly'",
    "request_id": "abcd1234"
  }
}

​
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

200
application/json

The response is of type object.