DeFi overview

Query DeFi TVL, USD-pegged stablecoin supply, DEX volumes, categories and top chains.

GET/api/v1/onchain/defi-overview
Domain
Network & Protocol
Level
Each request returns one DeFi market overview, including total value locked (TVL), stablecoin supply and DEX trading volume.
MCP tool
defi_overview (range=latest)

Available data

Returns
Query DeFi TVL, USD-pegged stablecoin supply, DEX volumes, categories and top chains.
What each request returns
Each request returns one DeFi market overview, including total value locked (TVL), stablecoin supply and DEX trading volume.

Authentication

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

Query Parameters

top_chainsintegerqueryExample2optional

Number of top chains in the latest overview. · Default: 10

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

DeFi market-wide TVL as a decimal string in USD. Its coverage differs from the platform aggregate at /platforms/overview

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

chain_countinteger

Number of covered chains

protocol_countinteger

Number of protocols in this scope

timestring

Date described by this overview; use this rather than observed_at or metadata.updated_at

obs_datestring

Source business date

rangestring

Query mode: latest or window

category_distributionobject[]

Protocol category breakdown. Category TVLs may not sum to global TVL

categoryobject[]

Protocol category, or category breakdown when returned as an array

top_chainsobject[]

Top chains ranked by TVL

category_distribution[]array[object]
categorystring

Protocol category, or category breakdown when returned as an array

category_keystring

Category identifier

protocol_countinteger

Number of protocols in this scope

tvl_usdstring

Category TVL in USD; category totals may not sum to market-wide TVL

top_chains[]array[object]
chain_idstring

Canonical chain identifier

chainstring

Chain name

chain_namestring

Chain display name

tvl_usdstring

Total value locked, as a decimal string in USD

gecko_idstring

Upstream token identifier

token_symbolstring

Chain token symbol

Errors & fallback

200
Business data returned.
401
Check the API key.
403
Check data-domain permissions for the key.