Chain activity history

Query daily active addresses and transaction counts over a historical window.

GET/api/v1/onchain/chains/{chain_id}/activity/history
Domain
Network & Protocol
Level
One activity record per chain and day
MCP tool
onchain_query (task=chain_activity, range=window)

Available data

Returns
Query daily active addresses and transaction counts over a historical window.
What each request returns
One activity record per chain and day

Authentication

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

Query Parameters

Chain or project
chain_idstringpathExamplechain_ethereumrequired

Canonical chain_* ID, for example chain_ethereum

Time range

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

fromstringqueryExample2026-11-01T00:00:00Zrequired

Start UTC date/time; must be earlier than to

tostringqueryExample2026-11-08T00:00:00Zrequired

End UTC date/time. Use a fixed historical window and inspect actual coverage

Return options
timeframestringqueryExample1doptional

Daily observations; only 1d is supported. · 1d · Default: 1d

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

seriesobject[]

Daily observations; an empty array means no covered observations

series[]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
Only part of the requested data is available. Inspect missing_fields, limitations and actual coverage.
200
No covered records for these filters. Empty arrays do not mean a measured zero.
400
A required parameter is missing; history queries require both from and to.
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.