Yield pools

Query DeFi pool TVL, annual percentage yields and pool attributes.

GET/api/v1/onchain/yield-pools
Domain
Network & Protocol
Level
A pool list or a single-pool snapshot.
MCP tool
yield_pools

Available data

Returns
Query DeFi pool TVL, annual percentage yields and pool attributes.
What each request returns
A pool list or a single-pool snapshot.

Authentication

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

Query Parameters

By pool

Use pool_id for one pool. Do not combine it with protocol_id

pool_idstringqueryoptional

Pool ID from a returned pool row. Mutually exclusive with protocol_id

By protocol

Use protocol_id to select pools for a protocol. Do not combine it with pool_id

protocol_idstringqueryExampleprotocol_lidooptional

Canonical protocol_* ID, for example protocol_lido. Mutually exclusive with pool_id

Additional REST filters

REST-only filters; the dedicated yield_pools MCP tool currently accepts only pool_id or protocol_id

assetstringqueryoptional

Asset symbol filter; REST only for the dedicated yield_pools tool

chainstringqueryoptional

Chain slug, for example ethereum. REST only for the dedicated yield_pools tool

protocolstringqueryoptional

Protocol slug filter, for example lido; REST only for the dedicated yield_pools tool

limitintegerqueryExample2optional

Maximum rows returned. · Default: 50 · ≤ 200

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

Pool identifier; pass through unchanged for an exact lookup

projectstring

Project slug

chain_idstring

Canonical chain identifier

chainstring

Chain name

symbolstring

Asset or pool token symbol

tvl_usdstring

Total value locked, as a decimal string in USD

apynumber

Annual percentage yield in percent: 2.2625 means 2.2625%, not 226.25%

apy_basenumber

Base APY in percent

apy_rewardnumber

Reward APY in percent; may be unavailable

stablecoinboolean

Whether the pool is a stablecoin pool

exposurestring

Single- or multi-asset exposure

il_riskstring

Impermanent-loss classification

underlying_tokensstring[]

Underlying token addresses

reward_tokensstring[]

Reward token addresses

metricsobject

Metrics for this object; see their units individually

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
Conflicting parameters: pool_id with protocol_id, or a sort field for a different bridge scope.
401
Check the API key.
403
Check data-domain permissions for the key.