Skip to main content
GET
/
v1
/
charts
/
{visualizationId}
/
data
Get Chart Data
curl --request GET \
  --url https://api.blockworks.com/v1/charts/{visualizationId}/data \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "dt": "2024-11-12T00:00:00.000Z",
      "btc_block_subsidy_usd": 40198390.03341997,
      "btc_profit": -38437320.788166374,
      "btc_txn_fees": 1761069.2452535906,
      "eth_block_subsidy_usd": 8466344.28558703,
      "eth_profit": 4042623.518063875,
      "eth_txn_fees": 12508967.803650904
    }
  ],
  "total": 123,
  "page": 123
}

​
Overview

Fetch chart data by chart ID. This endpoint returns the underlying data powering charts and visualizations, with support for pagination, filtering, and sorting. Use List Charts to fetch a list of charts or open the chart on https://app.blockworksresearch.com/analytics to grab the id from its URL.

​
Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.blockworks.com/v1/charts/3/data?limit=5&page=1"

​
Example Response

{
  "data": [
    {
      "dt": "2024-11-12T00:00:00.000Z",
      "btc_block_subsidy_usd": 40198390.03341997,
      "btc_profit": -38437320.788166374,
      "btc_txn_fees": 1761069.2452535906,
      "eth_block_subsidy_usd": 8466344.28558703,
      "eth_profit": 4042623.518063875,
      "eth_txn_fees": 12508967.803650904,
      "sol_block_subsidy_usd": 10791912.603590423,
      "sol_profit": -7419646.687582968,
      "sol_txn_fees": 3372265.916007456
    },
    {
      "dt": "2024-11-11T00:00:00.000Z",
      "btc_block_subsidy_usd": 35340104.40711805,
      "btc_profit": -34074762.00707391,
      "btc_txn_fees": 1265342.400044142,
      "eth_block_subsidy_usd": 8466344.28558703,
      "eth_profit": 2332989.5209395904,
      "eth_txn_fees": 10799333.80652662,
      "sol_block_subsidy_usd": 15086224.226297095,
      "sol_profit": -9486892.245268073,
      "sol_txn_fees": 5599331.9810290225
    }
  ],
  "page": 1,
  "total": 3386
}

​
Supported Options

NameTypeDetails
visualizationIdOrDashboardSlugpathThe ID of the visualization or dashboard slug.
limitqueryNumber of data points to return (1-100000, default: 10000).
pagequeryPage number for pagination (default: 1).
searchquerySearch term to filter data.
selectqueryArray of column names to include in response.
order_byqueryColumn name to sort by.
order_dirquerySort direction: “asc” or “desc” (default: “asc”).

​
Notes

  • Data structure varies by chart — each chart returns different columns based on its configuration.
  • Common fields include dt (datetime) and various metric columns with descriptive names.
  • Use select parameter to limit response to specific columns for better performance.
  • Large datasets are paginated — use limit and page for navigation.

​
See also

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
visualizationId
string
required

Query Parameters

​
page
integer
default:1
Required range: 1 <= x <= 2147483647
​
limit
integer
default:10000
Required range: 1 <= x <= 100000
​
search
string
Maximum string length: 255
​
select
string[]
Maximum string length: 255
​
order_by
string
Maximum string length: 255
​
order_dir
enum<string>
default:asc
Available options:
asc,
desc

Response

Successful response

Chart data response with dynamic columns. Each chart returns different data structure based on its configuration. Common fields include 'dt' (datetime) and various metric columns.

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