Chain activity metrics

Query staking and layer-two network metrics.

GET/api/v1/onchain/chain-metrics
Domain
Network & Protocol
Level
Aggregate
MCP tool
onchain_query (task=chain_activity)

Available data

Returns
Query staking and layer-two network metrics
What each request returns
Daily Ethereum staking, L2 and Bitcoin L2 metrics.

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Query example
Metric group

Staking, L2 and BTC L2 return different metrics and response branches. Select an example to inspect its request and response

metric_groupstringqueryExamplestakingrequired

Metric group · staking / l2 / btc_l2

Chain or project

project applies only to BTC L2; chain and chain_id select a chain for other groups

chainstringqueryExampleethereumoptional

Blockchain

Compatible aliases
chain_idstringqueryoptional

Chain identifier

projectstringqueryoptional

Applies only when metric_group=btc_l2. Accepted values: stacks, rootstock, merlin, bob, or bitlayer. Other values return not_in_scope

Time range

Use the endpoint’s documented time format and boundaries. Do not assume that missing dates mean zero

start_datedatequeryExample2026-10-19optional

Start date (YYYY-MM-DD)

end_datedatequeryExample2026-10-21optional

End date (YYYY-MM-DD)

lookbackstringqueryoptional

Lookback window, e.g. 30d

Return options
granularitystringqueryoptional

Time granularity · day · Default: day

limitintegerqueryoptional

Maximum rows · ≥ 0, ≤ 1000

Response

dataobject

Response data

chainstring

Blockchain

countnumber

Returned row count

data_statusDataStatus

Data status

duration_msnumber

duration_ms

end_datedatetime

End date (YYYY-MM-DD)

lookbackstring

Lookback window, e.g. 30d

metric_groupstring

Metric group

normalized_chainstring

normalized_chain

staking_metricsobject

Staking metric series

series[]object[]

Metric time series

data_statusDataStatus

Data status

datedatetime

Date

entry_queue_ethnumber

ETH in entry queue

entry_queue_validator_estimatenumber

Estimated entry validators

entry_wait_daysnumber

Entry waiting days

eth_supplynumber

ETH supply

exit_queue_ethnumber

ETH in exit queue

exit_queue_validator_estimatenumber

Estimated exit validators

exit_wait_daysnumber

Exit waiting days

staking_apr_7dnumber

Seven-day staking APR

staking_ratenumber

Staking rate

total_value_staked_ethnumber

Total staked ETH

validator_activenumber

Active validators

start_datedatetime

Start date (YYYY-MM-DD)

totalnumber

Total matching records

data_statusDataStatus

Data status

empty_reasonunknown | null

Reason for an empty result

errorunknown | null

Structured error; null when absent

external_refs[]unknown[]

external_refs

lineage_refs[]unknown[]

lineage_refs

metadataobject

Response metadata

actual_taskstring

actual_task

data_statusDataStatus

Data status

limitations[]unknown[]

Additional information

object_refs[]unknown[]

object_refs

updated_atdatetime

Data update time

request_idstring

Request identifier

source_refs[]unknown[]

source_refs

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.