Metrics
List Metrics by Project
Browse all available metrics for a specific project/chain
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 every metric available for a single project/chain by applying theproject query parameter. The response includes the metric name, description, stable identifier (used with Get Single Metric), data type, and data lineage source.
Quick summary
| What | Details |
|---|---|
| Purpose | Discover metrics for a specific project/chain |
| How to filter | Add ?project={project} to the request URL |
| Best next step | Copy the identifier, then query the series via GET /v1/metrics/{identifier} |
| Typical filters | identifier, limit, page |
| Pagination | Page-based via limit and page |
Basic Example
curl -H "x-api-key: YOUR_API_KEY" \\
"https://api.blockworks.com/v1/metrics?project=ethereum"
const res = await fetch('https://api.blockworks.com/v1/metrics?project=ethereum', {
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'},
params={'project': 'ethereum'}
)
data = r.json()
Filtering
Use query parameters to further narrow results for the chosen project:| Parameter | Type | Description | Example |
|---|---|---|---|
project | string | Chain/project slug | project=ethereum |
identifier | string | Filter by exact metric identifier | identifier=rev-usd |
limit | integer | Page size | limit=100 |
page | string | Page for pagination | page=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
| 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 GET /v1/metrics/{identifier} |
project | string | Chain/project slug (e.g., ethereum, base) |
source | string | Data lineage owner (e.g., Blockworks) |
data_type | string | Series shape and units (e.g., timeseries_usd, timeseries_float) |
parameters | object | Supported query parameters when fetching this 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?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
Query Parameters
Required range:
1 <= x <= 2147483647Required range:
1 <= x <= 100Example:
"Bitcoin,Ethereum"
Example:
"txns,issuance"