Skip to main content

Get lending pools

GET 

/v1/data/lending/pools

Returns paginated lending pool data with optional filters and sorting.

Server-side defaults (applied when the parameter is omitted; pass an explicit value to override):

ParameterDefault
minUtil0.1
maxUtil0.9
minTvlUsd100000 (Ethereum, chainId 1) / 25000 (all other chains)
maxRiskScore4 (medium; 6 = compromised is never admitted by default)

To disable a default filter, pass 0 (e.g. minUtil=0).

Oracle risk: each pool carries an oracleInfo object classifying its price oracle's feed correctness (provider, reported vs intended pair, a 0–100 worstScore/worstBand, and flags such as wrong-asset/correlated-proxy/cross-numeraire). This is distinct from the price-staleness signal in risk.breakdown[oracle]. See the OracleInfo schema for the full scoring model.

Credit desk: every row carries desk — the pool asset's credit desk (see CreditDesk), null when it names none (WETH, uncurated tokens).

Asset class: every row carries assetClass (stock · etf · pre-ipo · fund · credit · commodity, from token-lists props.rwa; null = not a tokenized real-world asset) and underlyingTicker (TSLA on every tokenized Tesla; equity classes only). Filter with assetClasses= and underlyingTickers=. underlyings= stays the list of token ADDRESSES it has always been.

Plain-text reference — GET /v1/data/lending/pools

Parameters

ParameterInTypeRequiredDescription
includeAMMquerybooleannoInclude Fluid smart (T2/T3/T4) vault legs. Excluded by default — a leg row names one token while the position is a two-token DEX LP; includeAMM=true opts in (rows then carry fluid / autoBalanced). Tokenized LP collateral (Lista …-SmartLP, Pendle LP) is an ordinary row and is not affected. Alias: includeAmm. The value is case-insensitive (true / 1); the parameter name is not.
chainIdquerystringnoFilter by chain ID See the ChainId schema for the full set of supported chains.
lenderquerystringnoFilter by lender key (e.g. AAVE_V3) See the LenderId schema for the full set of accepted values.
underlyingsquerystringnoComma-separated token addresses (0x-prefixed)
assetGroupsquerystringnoComma-separated asset group names
issuersquerystringnoCSV of issuer ids the pool's asset must be issued by, e.g. sky, ethena, circle. WHOSE CREDIT the asset is — not the money it is worth (USDe and USDC are both USD and are not the same credit), not the lender that hosts it. OR-ed across the listed ids; an asset has at most one desk per axis. Matches the asset's own desk OR its exposure desk by default (a PT over sUSDe answers to ethena); narrow with issuerMatch. Intersected with tags when both are given.
assetClassesquerystringnoCSV of asset classes the pool's asset must be of: stock, etf, pre-ipo, fund, credit, commodity, or the aliases stocks / equity (stock + etf + pre-ipo) and rwa (every class). Matches the row's assetClass. Read verbatim off token-lists props.rwa (equity/stock → stock, equity/pre-ipo → pre-ipo, fund/etf → etf, other funds → fund, credit → credit, commodity → commodity), never from a ticker. An asset with no class (crypto) never matches; an unknown value is a 400 naming the valid ones. Forwarded to the origin and applied again by the 1delta API on the stamped rows, so an origin that ignores it cannot widen the answer (the page may then come back short of count).
underlyingTickersquerystringnoCSV of real-world tickers the pool's asset must track (underlyingTicker, case-insensitive; equity classes only — TSLAx, TSLAon and Dinari's TSLA all answer to TSLA). ANDed with assetClasses.
issuerMatchqueryany, direct, exposure, creditnoWhich desk the issuer filter matches. any (default) spans BOTH the asset's own desk and the desk its underlying resolves to — a PT over sUSDe is Pendle's INSTRUMENT and Ethena's CREDIT, so it answers to issuers=pendle and to issuers=ethena in one call, with no client-side union. direct = only that desk's own instruments. exposure = only wrappers whose underlying resolves to it. credit = only pools whose asset's CREDIT DESK (the row's desk, see CreditDesk) is one of the ids: every asset has at most one, so under credit the issuers filter PARTITIONS the listing (a PT-sUSDe pool answers to ethena and never to pendle). Served by the 1delta API over the origin's any superset, scanning up to 10 origin pages of 1000; start/count apply after the filter, and total is null (with truncated: true) when the scan stopped before the end.
minYieldquerynumbernoMinimum deposit rate
maxYieldquerynumbernoMaximum deposit rate
minUtilquerynumbernoMinimum utilization (0-1). Defaults to 0.1 when omitted.
maxUtilquerynumbernoMaximum utilization (0-1). Defaults to 0.9 when omitted.
minTvlUsdquerynumbernoMinimum total liquidity in USD. Defaults to 100000 on Ethereum (chainId 1), 25000 on other chains.
maxTvlUsdquerynumbernoMaximum total liquidity in USD
minDepositsquerynumbernoMinimum total deposits (native units)
maxDepositsquerynumbernoMaximum total deposits (native units)
minDebtquerynumbernoMinimum total debt (native units)
maxDebtquerynumbernoMaximum total debt (native units)
minLiquidityquerynumbernoMinimum total liquidity (native units)
maxLiquidityquerynumbernoMaximum total liquidity (native units)
minDebtUsdquerynumbernoMinimum total debt in USD
maxDebtUsdquerynumbernoMaximum total debt in USD
minLiquidityUsdquerynumbernoMinimum total liquidity in USD
maxLiquidityUsdquerynumbernoMaximum total liquidity in USD
maxRiskScorequeryintegernoMaximum risk score (1–5; 6 = compromised — drained / insolvent / abandoned, see the risk schema). Defaults to 4 (medium) when omitted; a 6 is only returned when this is set to 6 explicitly.
includeExposuresquerybooleannoInclude config exposure data per pool. Opt-in; omit or false to skip (expensive).
sortByquerydepositRate, variableBorrowRate, stableBorrowRate, intrinsicYield, utilization, totalDeposits, … (11 values)noSort field
sortDirqueryASC, DESCnoSort direction
startqueryintegernoPagination offset
countqueryintegernoPage size (default 100, max 1000)

Response 200

FieldTypeDescription
successTrue
dataobject
data.startinteger
data.countintegerNumber of entries in items.
data.poolsobject[]
data.pools[].chain_idstringEVM chain id, as a decimal string. See the ChainId schema.
data.pools[].lender_keystring
data.pools[].underlying_addressstring
data.pools[].asset_groupstring
data.pools[].deposit_ratenumber
data.pools[].variable_borrow_ratenumber
data.pools[].stable_borrow_ratenumber
data.pools[].intrinsic_yieldnumber
data.pools[].utilizationnumberMarket utilization, as a fraction between 0 and 1.
data.pools[].total_depositsnumber
data.pools[].total_debtnumber
data.pools[].total_liquiditynumber
data.pools[].total_deposits_usdnumber
data.pools[].total_debt_usdnumber
data.pools[].total_liquidity_usdnumber
data.pools[].deskobjectThe pool asset's CREDIT DESK (see CreditDesk); null when it names none. Exactly what issuerMatch=credit matches.
data.pools[].assetClassstock, etf, pre-ipo, fund, credit, commodity, … (7 values)WHAT KIND of real-world asset the pool's asset is, read verbatim off token-lists props.rwa (equity/stock → stock, equity/pre-ipo → pre-ipo, fund/etf → etf, other funds → fund, credit, commodity). null = not a tokenized real-world asset. What assetClasses= matches.
data.pools[].underlyingTickerstringThe real-world ticker the pool's asset tracks, upper-cased (TSLA on TSLAx, TSLAon and Dinari's TSLA alike). Equity classes only; null otherwise.
actionsnull

Example response

{
"success": true,
"data": {
"start": 1,
"count": 1,
"pools": [
{
"chain_id": "string",
"lender_key": "AAVE_V3",
"underlying_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
"asset_group": "string",
"deposit_rate": 1.0,
"variable_borrow_rate": 1.0,
"stable_borrow_rate": 1.0,
"intrinsic_yield": 1.0,
"utilization": 1.0,
"total_deposits": 1.0,
"total_debt": 1.0,
"total_liquidity": 1.0,
"total_deposits_usd": 1.0,
"total_debt_usd": 1.0,
"total_liquidity_usd": 1.0,
"desk": {
"id": "ethena",
"name": "Ethena",
"kind": "string",
"via": "pendle",
"hops": 1
},
"assetClass": "stock",
"underlyingTicker": "string"
}
]
}
}

Request​

Responses​

Pool data