Chain activity

Query daily active addresses and transaction counts for a chain.

GET/api/v1/onchain/chains/{chain_id}/activity
Domain
Network & Protocol
Level
Latest daily observation for one chain.
MCP tool
onchain_query (task=chain_activity, range=latest)

Available data

Returns
Query daily active addresses and transaction counts for a chain.
What each request returns
Latest daily observation for one chain.

Authentication

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

Query Parameters

chain_idstringpathExamplechain_ethereumrequired

Canonical chain_* ID, for example chain_ethereum

Response

dataobject[]

Business data; shape is specific to this endpoint

data_statusDataStatus

Business status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage

errornull | string | object

Null on success; otherwise an error string or object

empty_reasonstring

Reason for an empty or unavailable result; may be absent

missing_fieldsstring[]

Fields not supplied by the source

coverage_fromstring

First date actually returned, not the requested start

coverage_tostring

Last date actually returned, not a guarantee of continuous coverage

coverage_notestring

Coverage and methodology notes

request_idstring

Request trace identifier

operation_idstring

Operation identifier

route_codestring

Response route identifier

observed_atstring

Response observation time; not the business snapshot date

metadataobject

Response metadata

updated_atstring

Metadata update time; not the business data time

object_refsobject[]

Matched object references

limitationsstring[]

Coverage or source limitations

data[]array[object]
chain_idstring

Canonical chain identifier

chainstring

Chain name

assetstring

Source chain-token symbol, for example eth

timestring

Business observation time in ISO 8601 UTC

obs_datestring

Source business date

obs_timestring

Source observation time

addresses_activeinteger

Unique daily active addresses, not unique users

transaction_countinteger

Daily chain transaction count, not token-transfer event count

activity_pair_statusstring

Pairing status of active addresses and transactions; paired means both are returned together

Errors & fallback

200
No covered records for these filters. Empty arrays do not mean a measured zero.
400
The supplied ID belongs to another object type.
400
Invalid parameter format, time range, scope, sorting or limit. Use the endpoint-specific rules above.
401
Check the API key.
403
Check data-domain permissions for the key.