Skip to main content

Get lending pairs

GET 
/v1/data/lending/pairs

Returns paginated leverage pair data with optional filters and sorting. Backed by the same origin route as /v1/data/lending/pairs/leverage, so it shares that endpoint's behaviour — including dropping pairs whose collateral leg has no remaining supply capacity (includeIlliquid=true keeps them).

Lista DAO fixed-term (brokered) debt side: when the short (debt) market is brokered, variableBorrowDisabledShort is true and termsShort[] lists the fixed-term loop options (each a MarketTerm). The pair has one loop option per term rather than a single variable-rate loop — use the per-term APR from termsShort[] in place of variableBorrowRateShort (which is 0/undefined for these pairs).

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

Parameters

ParameterInTypeRequiredDescription
chainIdquerystringnoFilter by chain ID See the ChainId schema for the full set of supported chains.
lenderquerystringnoFilter by lender key See the LenderId schema for the full set of accepted values.
assetGroupLongquerystringnoFilter by collateral asset group
assetGroupShortquerystringnoFilter by debt asset group
minAprquerynumbernoMinimum total APR
minLeveragequerynumbernoMinimum max leverage
minLiquidityUsdquerynumbernoMinimum liquidity in USD
includeIlliquidquerybooleannoKeep pairs whose collateral leg has no remaining supply capacity (un-openable at any size). Off by default.
sortByqueryaprTotal, maxLeverage, totalDepositsUsdLong, totalDebtUsdShortnoSort field
sortDirqueryasc, descnoSort direction
startqueryintegernoPagination start index
countqueryintegernoPage size

Response 200

FieldTypeDescription
successTrue
dataobject
data.startinteger
data.countintegerNumber of entries in items.
data.itemsobject[]The result set for this response.
data.items[].chainIdstringEVM chain id, as a decimal string. See the ChainId schema.
data.items[].lenderstringProtocol identifier. See the LenderId schema.
data.items[].marketLongUidstringMarket UID of the collateral side
data.items[].marketShortUidstringMarket UID of the debt side
data.items[].marketNameLongstringDisplay name of the collateral market/vault (e.g. the Euler eVault name). Disambiguates rows that share the collateral/debt token symbols and lender.
data.items[].marketNameShortstringDisplay name of the debt market/vault. For Euler this is the controller (debt) eVault — the primary way to tell otherwise-identical WETH→USDC rows apart.
data.items[].curatorNameLongstringCurator/brand of the collateral market (Euler: resolved from the vault governor). Null for lenders without a curator, or until the curator registry is seeded. Render as "curatorName + symbol", falling back to marketNameLong.
data.items[].curatorNameShortstringCurator/brand of the debt (controller) market. Same semantics as curatorNameLong.
data.items[].assetLongstringCollateral asset address
data.items[].assetShortstringDebt asset address
data.items[].assetGroupLongstring
data.items[].assetGroupShortstring
data.items[].symbolLongstringCollateral token symbol
data.items[].nameLongstringCollateral token name
data.items[].symbolShortstringDebt token symbol
data.items[].nameShortstringDebt token name
data.items[].collateralFactorLongnumberLiquidation collateral factor for the long side
data.items[].borrowCollateralFactorLongnumberBorrow-adjusted collateral factor for the long side
data.items[].borrowFactorLongnumberBorrow factor for the long side
data.items[].collateralDisabledLongbooleanWhether collateral is disabled for the long asset
data.items[].debtDisabledLongbooleanWhether debt is disabled for the long asset
data.items[].collateralFactorShortnumberLiquidation collateral factor for the short side
data.items[].borrowCollateralFactorShortnumberBorrow-adjusted collateral factor for the short side
data.items[].borrowFactorShortnumberBorrow factor for the short side
data.items[].collateralDisabledShortbooleanWhether collateral is disabled for the short asset
data.items[].debtDisabledShortbooleanWhether debt is disabled for the short asset
data.items[].eModeConfigIdstringE-mode configuration ID
data.items[].eModestringE-mode category
data.items[].aprBasenumberBase APR (deposit - borrow + intrinsic, before rewards)
data.items[].aprTotalnumberTotal APR (base + rewards)
data.items[].maxLeveragenumberHighest leverage multiple reachable in this market.
data.items[].ltvnumberLoan-to-value ratio (0-1)
data.items[].depositRateLongnumber
data.items[].variableBorrowRateShortnumber
data.items[].intrinsicYieldLongnumber

Example response

{
  "success": true,
  "data": {
    "start": 1,
    "count": 1,
    "items": [
      {
        "chainId": "1",
        "lender": "AAVE_V3",
        "marketLongUid": "string",
        "marketShortUid": "string",
        "marketNameLong": "string",
        "marketNameShort": "string",
        "curatorNameLong": "string",
        "curatorNameShort": "string",
        "assetLong": "string",
        "assetShort": "string",
        "assetGroupLong": "string",
        "assetGroupShort": "string",
        "symbolLong": "string",
        "nameLong": "string",
        "symbolShort": "string",
        "nameShort": "string",
        "collateralFactorLong": 0.94,
        "borrowCollateralFactorLong": 0.92,
        "borrowFactorLong": 1,
        "collateralDisabledLong": true,
        "debtDisabledLong": true,
        "collateralFactorShort": 0.94,
        "borrowCollateralFactorShort": 0.92,
        "borrowFactorShort": 1,
        "collateralDisabledShort": true,
        "debtDisabledShort": true,
        "eModeConfigId": "string",
        "eMode": "string",
        "aprBase": 1.0,
        "aprTotal": 1.0,
        "maxLeverage": 1.0,
        "ltv": 1.0,
        "depositRateLong": 1.0,
        "variableBorrowRateShort": 1.0,
        "intrinsicYieldLong": 1.0,
        "intrinsicYieldShort": 1.0,
        "variableBorrowDisabledShort": true,
        "termsShort": [
          {
            "termId": 2,
            "depositApr": 1.0,
            "available": 1.0,
            "durationDays": 7,
            "durationSecs": 604800,
            "apr": 3.85,
            "aprAtAmount": 1.0,
            "fillable": 1.0,
            "capped": true,
            "ladder": [
              {
                "apr": 1.0,
                "units": "string",
                "assets": 1.0
              }
            ]
          }
        ],
        "fixedTerm": {
          "model": "term",
          "maturity": 1,
          "fees": {},
          "earlyRepay": {},
          "provider": {},
          "auction": {
            "status": "open",
            "canBorrow": true,
            "canLend": true,
            "secondsUntilClose": 263000,
            "implications": [
              "string"
            ],
            "id": "string",
            "startTime": 1,
            "revealTime": 1,
            "endTime": 1,
            "minBorrowAmount": "1000000000",
            "minLendAmount": "1000000000"
          }
        },
        "rewardAprLong": 1.0,
        "rewardAprShort": 1.0,
        "rewardsLong": [
          {}
        ],
        "rewardsShort": [
          {}
        ],
        "totalDepositsLong": 1.0,
        "totalDebtLong": 1.0,
        "totalLiquidityLong": 1.0,
        "totalDepositsShort": 1.0,
        "totalDebtShort": 1.0,
        "totalLiquidityShort": 1.0,
        "totalDepositsUsdLong": 1.0,
        "totalDebtUsdLong": 1.0,
        "totalLiquidityUsdLong": 1.0,
        "totalDepositsUsdShort": 1.0,
        "totalDebtUsdShort": 1.0,
        "totalLiquidityUsdShort": 1.0,
        "borrowLiquidityShort": 1.0,
        "withdrawLiquidityLong": 1.0,
        "depositableLong": 1.0,
        "utilizationLong": 1.0,
        "utilizationShort": 1.0,
        "underlyingInfoLong": {
          "asset": {},
          "prices": {},
          "oraclePrice": {}
        },
        "underlyingInfoShort": {
          "asset": {},
          "prices": {},
          "oraclePrice": {}
        }
      }
    ]
  }
}

Request​

Responses​

Pair data