Skip to main content

LendingLatestItem

Aggregated lending data for a single lender on a single chain.

chainIdstringrequired
Example: 8453
lenderInfo objectrequired

Protocol/lender metadata (name, logo).

keystring

Lender key identifier

Example: AAVE_V3
namestringnullable

Human-readable lender name

Example: Aave V3
logoURIstringnullable

Lender logo URL

Example: https://raw.githubusercontent.com/1delta-DAO/protocol-icons/main/lender/aave_v3.webp
lastFetchednumbernullable

Epoch ms of latest snapshot

totalDepositsUsdnumberrequired

Total deposits across all markets in USD

totalDebtUsdnumberrequired

Total debt across all markets in USD

tvlUsdnumberrequired

Total value locked in USD (deposits - debt)

params objectnullable

Lender-specific parameters. Only present for Morpho/Lista lenders (e.g. { market: { … } }).

property name*anynullable

Lender-specific parameters. Only present for Morpho/Lista lenders (e.g. { market: { … } }).

markets object[]required

Individual lending markets for this lender on this chain

  • Array [
    • lenderKeystring

    Protocol identifier

    Example: AAVE_V3
    poolIdstring

    Pool/vault address or protocol-specific ID

    depositRatenumbernullable

    Deposit APR (percent)

    variableBorrowRatenumbernullable

    Variable borrow APR (percent)

    stableBorrowRatenumbernullable

    Stable borrow APR (percent)

    intrinsicYieldnumbernullable

    Intrinsic yield APR from underlying asset (e.g. stETH staking)

    totalDepositsnumbernullable

    Total deposits in token units

    totalDebtStablenumbernullable

    Total stable debt in token units

    totalDebtnumbernullable

    Total variable debt in token units

    totalLiquiditynumbernullable

    Available liquidity (totalDeposits - totalDebt) in token units

    totalDepositsUsdnumbernullable

    Total deposits in USD

    totalDebtStableUsdnumbernullable

    Total stable debt in USD

    totalDebtUsdnumbernullable

    Total variable debt in USD

    totalLiquidityUsdnumbernullable

    Available liquidity in USD

    utilizationnumbernullable

    Utilization ratio (totalDebt / totalDeposits)

    decimalsintegernullable
    underlyingInfo object

    Nested asset metadata, oracle prices, and market prices for a lending market.

    asset object

    Token metadata for an underlying asset.

    chainIdstring
    Example: 1
    addressstring

    Token contract address (lowercase)

    Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
    symbolstring
    Example: USDC
    namestring
    Example: USD Coin
    decimalsintegernullable
    Example: 6
    logoURIstringnullable
    assetGroupstringnullable

    Canonical asset group (e.g. "USDC", "ETH", "BTC")

    Example: USDC
    currencyIdstringnullable
    props objectnullable

    Protocol-specific asset properties

    property name*anynullable

    Protocol-specific asset properties

    oraclePrice object

    On-chain oracle price data.

    oraclePricenumbernullable

    Raw on-chain oracle price

    oraclePriceUsdnumbernullable

    Oracle price denominated in USD

    prices object

    Market prices for an asset with 24h comparison.

    priceUsdnumbernullable

    Current price in USD

    priceTsstring<date-time>nullable

    Timestamp of current price

    priceUsd24hnumbernullable

    Price 24 hours ago in USD

    priceTs24hstring<date-time>nullable

    Timestamp of 24h-ago price

    priceChange24hnumbernullable

    Percentage price change over 24h

    oracleInfo objectnullable

    Oracle feed-correctness classification for the market's price oracle(s). null when the market has no oracle classification.

    This is feed correctness — does the oracle price the right asset in the right unit — and is distinct from the price-staleness signal carried in risk.breakdown[oracle] (a 1–5 score). A market can have several feeds (Compound comets price each collateral asset; Fluid prices each vault side), so feeds is an array and worstScore/worstBand summarize the riskiest one.

    Scoring (per feed, additive): score = provider base + flag penalties, clamped 0–100.

    Provider base (oracle mechanism; first match wins):

    ProviderBase
    chainlink, price-cap10
    redstone/pyth/chronicle/… and unrecognized18
    composite / cross-feed22
    exchange-rate / pendle-pt / LST rate adapters28
    twap/uniswap/DEX30
    fixed-rate / constant55

    Flag penalties (added on top): wrong-asset +45 · correlated-proxy +18 · cross-numeraire +18 · undecoded-source +8.

    Bands: LOW < 25 · MEDIUM 25–49 · HIGH 50–74 · CRITICAL ≥ 75.

    feeds object[]required

    Per-feed classifications, ordered worst-first.

  • Array [
    • assetstringnullable

    Priced asset symbol (the reported numerator).

    oraclestringnullable

    Oracle / feed / adapter address (lowercased).

    providerstringnullable

    Oracle mechanism: chainlink, redstone, pyth, chronicle, composite, price-cap (Aave PriceCapAdapter), exchange-rate (correlated/LST, e.g. Venus OneJumpOracle), pendle-pt, constant, or a lender-specific stub (compound-v2-oracle, dolomite-oracle, fluid-oracle).

    priceDescriptionstringnullable

    Decoded reported pair, e.g. "WBTC / USD"; "UNKNOWN" when the source could not be decoded.

    intendedPairstringnullable

    What the feed should report: "<asset> / <numeraire>".

    correctOraclebooleannullable

    Does the feed price the intended asset (numerator match)? null = unverifiable.

    denominatorMatchbooleannullable

    Is the feed denominated in the right numeraire (e.g. the loan token / market unit)? null = unknown.

    fixedRateboolean

    Hardcoded/constant price feed.

    scoreinteger

    Feed risk score 0–100. See OracleInfo for the model.

    bandstring

    Risk band for score.

    Possible values: [LOW, MEDIUM, HIGH, CRITICAL]

    flagsstring[]

    Risk flags: wrong-asset, correlated-proxy, cross-numeraire, undecoded-source, fixed-rate, unrecognized-provider.

  • ]
    • worstScoreintegerrequired

    Highest (worst) score across feeds.

    worstBandstringrequired

    Band of the worst feed.

    Possible values: [LOW, MEDIUM, HIGH, CRITICAL]

    caps object

    Supply, borrow, and debt ceiling caps for a lending market.

    borrowCapnumbernullable

    Maximum borrowable amount (token units)

    supplyCapnumbernullable

    Maximum depositable amount (token units)

    debtCeilingstringnullable

    Isolation-mode debt ceiling

    flags object

    Boolean flags describing the operational status of a lending market. Values may be null if unavailable from the protocol.

    isActivebooleannullable

    Whether the market is active

    isFrozenbooleannullable

    Whether the market is frozen (no new deposits/borrows)

    hasStablebooleannullable

    Whether stable-rate borrowing is available

    borrowingEnabledbooleannullable

    Whether borrowing is enabled

    depositsEnabledbooleannullable

    Whether deposits are enabled

    collateralActivebooleannullable

    Whether the asset can be used as collateral

    variableBorrowDisabledbooleannullable

    Whether variable-rate borrowing is unavailable through 1delta for this market. true for Lista DAO fixed-term (brokered) markets, where borrows must go through the broker and pick a fixed term from terms[]. Together with a non-empty terms[] this is the canonical "brokered market" signal — such markets report variableBorrowRate = 0 but cannot be borrowed variably.

    rewards object[]

    Active reward programs. Defaults to [] when none.

  • Array [
    • assetstring

    Reward token address

    depositRatenumber

    Reward APR on deposits

    variableBorrowRatenumber

    Reward APR on variable borrows

    stableBorrowRatenumber

    Reward APR on stable borrows

  • ]
    • config object

    Risk config keyed by mode/category ID (e.g. "0" for default, "1" for e-mode)

    property name* MarketConfigEntry

    Risk parameters for a specific e-mode or collateral category.

    categorystring

    E-mode category identifier

    Example: 1
    labelstring

    Human-readable label for this config category

    Example: ETH correlated
    borrowCollateralFactornumbernullable

    LTV for borrowing (0-1)

    Example: 0.8
    collateralFactornumbernullable

    Liquidation threshold (0-1)

    Example: 0.85
    borrowFactornumbernullable

    Borrow factor (typically 1)

    Example: 1
    liquidationPenaltynumbernullable

    Liquidation penalty for this mode, as a fraction of repaid debt the liquidator receives on top of par (e.g. 0.05 = 5%). Mode-specific where supported (Aave e-modes, Dolomite categories, Euler vaults).

    Example: 0.05
    closeFactornumbernullable

    Max fraction of debt repayable per liquidation (0-1). Mirrors the pool-level closeFactor; not e-mode-specific in any supported protocol, so the same value across every mode of a market.

    Example: 0.5
    targetHealthFactornumbernullable

    Liquidation target health factor (e.g. 1.05). Set only by protocols that liquidate to a target HF instead of a fixed close factor (Aave V4, spoke-level); omitted otherwise.

    Example: 1.05
    collateralDisabledboolean
    debtDisabledboolean
    terms object[]nullable

    Fixed-term rate card for Lista DAO brokered markets. Non-empty ⇒ the market is brokered (borrow via the broker, pick a termId); null ⇒ a regular variable-rate market. Together with flags.variableBorrowDisabled this is the canonical brokered-market signal.

  • Array [
    • termIdinteger

    Broker-defined term identifier. Pass to /v1/actions/lending/borrow?termId=…. Numeric on-chain; some upstream feeds serialize it as a string — coerce with Number() when comparing.

    Example: 2
    durationDaysnumber

    How long the position is locked at the fixed rate, in days (e.g. 7, 14, 30).

    Example: 7
    durationSecsnumbernullable

    Term duration in seconds (raw on-chain value).

    Example: 604800
    aprnumber

    Annualised borrow APR for this term, in percent (e.g. 3.85 = 3.85%). Same unit as variableBorrowRate / stableBorrowRate.

    Example: 3.85
  • ]
    • brokerstringnullable

    Lista DAO LendingBroker contract address — the mandatory gateway for the debt side (borrow/repay) of a brokered market. Present (non-zero) only for brokered markets. The borrow/repay calldata routes through this contract (the SDK and worker resolve it automatically).

    Example: 0x1fa26015286d1270343d7526c60bd57ab6be8b54
    collateralProviderstringnullable

    Lista DAO collateral-provider contract for this market. When set (non-zero), Moolah gates supplyCollateral/withdrawCollateral behind it, so collateral deposits/withdrawals must route through this provider rather than calling Moolah directly (the SDK/worker handle this). Set for markets whose collateral is a Lista-managed token (e.g. slisBNB); null for plain ERC-20 collateral.

    Example: 0x33f7a980a246f9b8fea2254e3065576e127d4d5f
    loanProviderstringnullable

    Lista DAO loan-token provider contract for this market (e.g. the native-WBNB wrapper provider). When set, loan-token operations are gated behind it; for brokered markets the broker handles the debt side. Informational — consumers do not pass it; the SDK/worker resolve routing automatically.

    Example: 0x367384c54756a25340c63057d87ea22d47fd5701
    closeFactornumbernullable

    Max fraction of a borrower's debt repayable in a single liquidation (0-1). Aave ~0.5 (rises to 1 below the close-factor health threshold), Compound V2 closeFactorMantissa; 1 (full liquidation) for isolated / credit-account protocols (Compound V3, Morpho, Euler, Fluid, Gearbox, Dolomite, Silo).

    Example: 0.5
    targetHealthFactornumbernullable

    Liquidation target health factor (e.g. 1.05). Set only by protocols that liquidate to a target HF rather than a fixed close factor (Aave V4, spoke-level); omitted otherwise.

    Example: 1.05
    lenderInfo object

    Protocol/lender metadata (name, logo).

    keystring

    Lender key identifier

    Example: AAVE_V3
    namestringnullable

    Human-readable lender name

    Example: Aave V3
    logoURIstringnullable

    Lender logo URL

    Example: https://raw.githubusercontent.com/1delta-DAO/protocol-icons/main/lender/aave_v3.webp
    property name*any

    Enriched lending market data as returned by /lending and /pools endpoints. Numeric fields are parsed to number | null.

  • ]
    • LendingLatestItem
    {
      "chainId": "8453",
      "lenderInfo": {
        "key": "AAVE_V3",
        "name": "Aave V3",
        "logoURI": "https://raw.githubusercontent.com/1delta-DAO/protocol-icons/main/lender/aave_v3.webp"
      },
      "lastFetched": 0,
      "totalDepositsUsd": 0,
      "totalDebtUsd": 0,
      "tvlUsd": 0,
      "params": {},
      "markets": [
        {
          "lenderKey": "AAVE_V3",
          "poolId": "string",
          "depositRate": 0,
          "variableBorrowRate": 0,
          "stableBorrowRate": 0,
          "intrinsicYield": 0,
          "totalDeposits": 0,
          "totalDebtStable": 0,
          "totalDebt": 0,
          "totalLiquidity": 0,
          "totalDepositsUsd": 0,
          "totalDebtStableUsd": 0,
          "totalDebtUsd": 0,
          "totalLiquidityUsd": 0,
          "utilization": 0,
          "decimals": 0,
          "underlyingInfo": {
            "asset": {
              "chainId": "1",
              "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6,
              "logoURI": "string",
              "assetGroup": "USDC",
              "currencyId": "string",
              "props": {}
            },
            "oraclePrice": {
              "oraclePrice": 0,
              "oraclePriceUsd": 0
            },
            "prices": {
              "priceUsd": 0,
              "priceTs": "2024-07-29T15:51:28.071Z",
              "priceUsd24h": 0,
              "priceTs24h": "2024-07-29T15:51:28.071Z",
              "priceChange24h": 0
            }
          },
          "oracleInfo": {
            "feeds": [
              {
                "asset": "string",
                "oracle": "string",
                "provider": "string",
                "priceDescription": "string",
                "intendedPair": "string",
                "correctOracle": true,
                "denominatorMatch": true,
                "fixedRate": true,
                "score": 0,
                "band": "LOW",
                "flags": [
                  "string"
                ]
              }
            ],
            "worstScore": 0,
            "worstBand": "LOW"
          },
          "caps": {
            "borrowCap": 0,
            "supplyCap": 0,
            "debtCeiling": "string"
          },
          "flags": {
            "isActive": true,
            "isFrozen": true,
            "hasStable": true,
            "borrowingEnabled": true,
            "depositsEnabled": true,
            "collateralActive": true,
            "variableBorrowDisabled": true
          },
          "rewards": [
            {
              "asset": "string",
              "depositRate": 0,
              "variableBorrowRate": 0,
              "stableBorrowRate": 0
            }
          ],
          "config": {},
          "terms": [
            {
              "termId": 2,
              "durationDays": 7,
              "durationSecs": 604800,
              "apr": 3.85
            }
          ],
          "broker": "0x1fa26015286d1270343d7526c60bd57ab6be8b54",
          "collateralProvider": "0x33f7a980a246f9b8fea2254e3065576e127d4d5f",
          "loanProvider": "0x367384c54756a25340c63057d87ea22d47fd5701",
          "closeFactor": 0.5,
          "targetHealthFactor": 1.05,
          "lenderInfo": {
            "key": "AAVE_V3",
            "name": "Aave V3",
            "logoURI": "https://raw.githubusercontent.com/1delta-DAO/protocol-icons/main/lender/aave_v3.webp"
          }
        }
      ]
    }