Skip to main content
GET
Batch Get Blockchain timeseries

Authorizations

X-Blockworks-API-Key
string
header
required

API key sent in the X-Blockworks-API-Key header; x-messari-api-key is accepted for existing integrations. The catalog endpoints and models on the public access tier need no key.

Path Parameters

granularity
enum<string>
required

Data granularity.

Available options:
1d,
1w

Query Parameters

series
string
required

Comma-separated Network ID values naming the series to return (up to 10). Required: this model has too many series to return at once.

timeframe
string

Time window, one of: to-date (ytd, qtd, mtd, dtd, htd); relative, followed by m, h, d or w (30d, 12h, 4w; 1y and 1M are not accepted, use 365d, 52w, ytd or a calendar year); a calendar day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY); or an RFC3339 instant, which runs from then to now. Mutually exclusive with start/end. Default: everything retained, up to now.

start
string

Window start, inclusive (RFC3339, unix seconds, or YYYY-MM-DD). Default: unbounded.

end
string

Window end, exclusive (RFC3339, unix seconds, or YYYY-MM-DD). Default: now.

bounds
boolean

If true, return only the first and last point of the resolved time window instead of every point in it.

selections
enum<string>[]

Comma-separated metric fields to return; defaults to every metric. A point always leads with its timestamp, and the values that follow are described by point_schema in catalog order regardless of the order requested here.

Available options:
successful-transactions,
unsuccessful-transactions,
new-addresses,
returning-addresses,
active-contracts,
total-contract-calls,
new-contracts-called,
returning-contracts-called,
unique-contract-callers,
dex-volume-usd,
dex-volume-dominance,
options-volume,
bridge-deposit-volume,
bridge-withdraw-volume,
bridge-net-flow,
bridge-deposit-transactions,
bridge-withdraw-transactions,
bridge-net-flow-transactions,
total-blocks,
min-block-number,
max-block-number,
block-producers,
contract-call-gas-payers,
new-contract-deployers,
estimated-nakamoto-coefficient,
gas-spenders,
total-stablecoin-circulating,
circulating-marketcap,
total-transactions,
block-time-ms,
transactions-per-second,
active-addresses,
new-contracts-deployed,
contract-deployers,
fee-revenue,
fee-median,
rolling-7d-avg-transaction-fees,
average-fee-per-transaction,
fees-total-usd,
fees-supply-side-usd,
expenses-usd,
real-economic-value-usd,
token-incentives-usd,
stablecoin-mints-usd,
stablecoin-burns-usd,
stablecoin-outstanding-supply-usd,
stablecoin-transfer-volume-usd,
stablecoin-transfer-count,
stablecoin-transfer-avg-value-usd,
stablecoin-active-addresses,
stablecoin-total-addresses,
stablecoin-transaction-volume-usd,
stablecoin-transaction-count,
stablecoin-avg-transaction-value-usd,
tvl-usd,
tvl-dominance,
ecosystem-dex-volume-usd,
ecosystem-fees-usd,
code-commits,
active-developers,
ecosystem-code-commits,
tvs-usd,
avg-gas-per-second,
operations-count,
operations-active-addresses,
trx-transaction-volume-usd,
trx-transaction-volume,
trx-transaction-count,
trx-transfers-count,
usdt-transfers-count,
avg-trx-transfer-fee-usd,
avg-trx-transfer-fee-native,
avg-usdt-transfer-fee-usd,
avg-usdt-transfer-fee-native,
free-txns-count-trx-burned,
free-txns-count-trx-staking,
total-free-transactions-count,
trx-burned-usd,
trx-burned,
claimed-staking-rewards-usd,
claimed-staking-rewards-native,
sr-staking-rewards-usd,
sr-staking-rewards-native,
srp-staking-rewards-usd,
srp-staking-rewards-native,
staking-apy,
real-yield-apy,
energy-utilization-rate,
energy-price-justlend,
energy-stake-income-native,
energy-stake-income-usd,
fees-paid-to-l2-usd,
rent-paid-to-l1-usd,
total-value-secured-usd,
number-of-validators,
gas-used,
trading-volume-usd,
borrowed-usd,
borrowed-dominance,
capital-deployed,
pf-circulating,
ps-circulating,
tvl-native,
rwa-tvl-usd,
rwa-tokenholders,
rwa-project-count,
rwa-asset-market-cap-usd,
rwa-capital-deployed-usd,
rwa-outstanding-supply-usd,
total-staked-native,
total-staked-usd,
staking-rate-pct,
validator-count,
delegator-count,
liquid-staked-native,
liquid-staked-usd,
liquid-staking-rate-pct,
native-staked-native,
native-staked-usd,
net-stake-flow-native,
net-stake-flow-usd,
staking-apr-30d-pct,
staking-apy-30d-pct,
real-staking-apy-30d-pct,
staking-inflation-rate-30d-pct,
staking-rewards-native,
staking-rewards-usd,
active-validator-count,
staker-count,
avg-validator-commission-rate,
stake-weighted-commission-rate,
spot-dex-trade-count,
perp-dex-volume-usd,
perp-dex-open-interest-usd,
perp-dex-trade-count,
perp-dex-fees-usd,
perp-dex-revenue-usd,
lending-tvl-usd,
app-revenue-usd,
stablecoin-count,
stablecoin-usd-pegged-supply-usd,
stablecoin-non-usd-pegged-supply-usd,
stablecoin-balance-protocol-owned-usd,
stablecoin-balance-bridge-usd,
stablecoin-balance-cex-usd,
stablecoin-balance-perp-dex-usd,
stablecoin-balance-spot-dex-usd,
stablecoin-balance-lending-usd,
stablecoin-balance-unknown-usd,
stablecoin-bwr-mints-usd,
stablecoin-bwr-burns-usd,
stablecoin-holders,
stablecoin-transfer-senders,
stablecoin-transfer-receivers
acceptFormat
enum<string>
default:json

Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file.

Available options:
json,
csv,
jsonl

Response

Timeseries points for each series.

data
object
required
error
string | null