Skip to main content
GET
/
v1
/
charts
List Charts
curl --request GET \
  --url https://api.blockworks.com/v1/charts \
  --header 'x-api-key: <api-key>'
{
  "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"

​
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

NameTypeDetails
limitqueryThe number of charts to return (1-100, default: 100).
pagequeryThe page number to return (default: 1).
searchquerySearch term to filter charts by title or description.

​
Notes

  • Results are paginated — use limit and page query parameters to navigate.
  • Chart identifiers returned here can be used to retrieve chart data via other endpoints.
  • Use the search parameter to find specific charts by keywords.

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
​
search
string
Maximum length: 255

Response

Successful response

​
data
object[]
required
​
total
integer
required
​
page
integer
required