Chart Data
List Charts
Retrieve a paginated list of available charts
GET
/
v1
/
charts
List Charts
curl --request GET \
--url https://api.blockworks.com/v1/charts \
--header 'x-api-key: <api-key>'import requests
url = "https://api.blockworks.com/v1/charts"
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/charts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": 123,
"title": "<string>",
"dashboards": [
"<string>"
]
}
],
"total": 123,
"page": 123
}Overview
This endpoint returns a paginated list of charts available through the API. Use Get Chart Data to fetch the underlying chart data.Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://api.blockworks.com/v1/charts?limit=20"
const response = await fetch(
'https://api.blockworks.com/v1/charts?limit=20',
{ headers: { 'x-api-key': 'YOUR_API_KEY' } }
)
const data = await response.json()
import requests
response = requests.get(
'https://api.blockworks.com/v1/charts',
headers={'x-api-key': 'YOUR_API_KEY'},
params={'limit': 20}
)
data = response.json()
Example Response
{
"data": [
{
"id": 3,
"title": "Block Subsidy",
"dashboards": []
},
{
"id": 5,
"title": "L1 Usage",
"dashboards": []
},
{
"id": 13,
"title": "ETH Staking Yield (Weekly Basis Test Case)",
"dashboards": [
"Test Aaron"
]
},
{
"id": 18,
"title": "MEV Tips to Validators",
"dashboards": []
},
{
"id": 34,
"title": "Arbitrum: Total Transaction Fees",
"dashboards": []
}
],
"total": 3228,
"page": 1
}
Supported Options
| Name | Type | Details |
|---|---|---|
limit | query | The number of charts to return (1-100, default: 100). |
page | query | The page number to return (default: 1). |
search | query | Search term to filter charts by title or description. |
Notes
- Results are paginated — use
limitandpagequery parameters to navigate. - Chart identifiers returned here can be used to retrieve chart data via other endpoints.
- Use the
searchparameter to find specific charts by keywords.
Related Endpoints
Authorizations
Query Parameters
Required range:
1 <= x <= 2147483647Required range:
1 <= x <= 100Maximum string length:
255