DeFi overview history

Query daily DeFi TVL, stablecoin supply and DEX volume snapshots over a historical window.

GET/api/v1/onchain/defi-overview/history
Domain
Network & Protocol
Level
One overview record per day
MCP tool
defi_overview (range=window)

Available data

Returns
Query daily DeFi TVL, stablecoin supply and DEX volume snapshots over a historical window.
What each request returns
One overview record per day

Authentication

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

Query Parameters

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]
timestring

Business observation time in ISO 8601 UTC

datestring

Business date (YYYY-MM-DD)

obs_datestring

Source business date

tvl_usdstring

Total value locked, as a decimal string in USD

stablecoin_supply_usdstring

USD-pegged stablecoin supply in USD; not market capitalization of all stablecoin types

total_dex_spot_volume_24hstring

Rolling 24-hour DEX spot volume at this snapshot, in USD; not net flow or UTC calendar-day volume

total_dex_perps_volume_24hstring

Rolling 24-hour DEX perpetual volume at this snapshot, in USD. Do not sum adjacent snapshots as multi-day volume

fromstring

Requested start time

tostring

Requested end time

rangestring

Query mode: latest or window

Errors & fallback

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.