Yield pools
Query DeFi pool TVL, annual percentage yields and pool attributes.
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
Query Parameters
Use pool_id for one pool. Do not combine it with protocol_id
pool_idstringqueryoptionalPool ID from a returned pool row. Mutually exclusive with protocol_id
Use protocol_id to select pools for a protocol. Do not combine it with pool_id
protocol_idstringqueryExampleprotocol_lidooptionalCanonical protocol_* ID, for example protocol_lido. Mutually exclusive with pool_id
REST-only filters; the dedicated yield_pools MCP tool currently accepts only pool_id or protocol_id
assetstringqueryoptionalAsset symbol filter; REST only for the dedicated yield_pools tool
chainstringqueryoptionalChain slug, for example ethereum. REST only for the dedicated yield_pools tool
protocolstringqueryoptionalProtocol slug filter, for example lido; REST only for the dedicated yield_pools tool
limitintegerqueryExample2optionalMaximum rows returned. · Default: 50 · ≤ 200
Response
dataobject[]Business data; shape is specific to this endpoint
data_statusDataStatusBusiness status: verified/ok, partial, no_data or not_ready. HTTP 200 alone does not establish coverage
errornull | string | objectNull on success; otherwise an error string or object
empty_reasonstringReason for an empty or unavailable result; may be absent
missing_fieldsstring[]Fields not supplied by the source
coverage_fromstringFirst date actually returned, not the requested start
coverage_tostringLast date actually returned, not a guarantee of continuous coverage
coverage_notestringCoverage and methodology notes
request_idstringRequest trace identifier
operation_idstringOperation identifier
route_codestringResponse route identifier
observed_atstringResponse observation time; not the business snapshot date
Response metadata
updated_atstringMetadata update time; not the business data time
object_refsobject[]Matched object references
limitationsstring[]Coverage or source limitations
pool_idstringPool identifier; pass through unchanged for an exact lookup
projectstringProject slug
chain_idstringCanonical chain identifier
chainstringChain name
symbolstringAsset or pool token symbol
tvl_usdstringTotal value locked, as a decimal string in USD
apynumberAnnual percentage yield in percent: 2.2625 means 2.2625%, not 226.25%
apy_basenumberBase APY in percent
apy_rewardnumberReward APY in percent; may be unavailable
stablecoinbooleanWhether the pool is a stablecoin pool
exposurestringSingle- or multi-asset exposure
il_riskstringImpermanent-loss classification
underlying_tokensstring[]Underlying token addresses
reward_tokensstring[]Reward token addresses
metricsobjectMetrics for this object; see their units individually