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 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

WhatDetails
PurposeDiscover metrics for a specific project/chain
How to filterAdd ?project={project} to the request URL
Best next stepCopy the identifier, then query the series via GET /v1/metrics/{identifier}
Typical filtersidentifier, limit, page
PaginationPage-based via limit and page

​
Basic Example

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

​
Filtering

Use query parameters to further narrow results for the chosen project:
ParameterTypeDescriptionExample
projectstringChain/project slugproject=ethereum
identifierstringFilter by exact metric identifieridentifier=rev-usd
limitintegerPage sizelimit=100
pagestringPage for paginationpage=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

FieldTypeDescription
namestringHuman-readable metric name
descriptionstringWhat the metric measures and how it’s intended to be used
identifierstringStable key used with GET /v1/metrics/{identifier}
projectstringChain/project slug (e.g., ethereum, base)
sourcestringData lineage owner (e.g., Blockworks)
data_typestringSeries shape and units (e.g., timeseries_usd, timeseries_float)
parametersobjectSupported query parameters when fetching this 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?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
}

​
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