Metrics
List Metrics
Browse and filter available metrics
GET
/
v1
/
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, stableidentifier, 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. Passlimit 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
Query Parameters
Required range:
1 <= x <= 2147483647Required range:
1 <= x <= 100Example:
"Bitcoin,Ethereum"
Example:
"txns,issuance"