# Get lending pairs

Endpoint reference for the 1delta API. Index: https://docs.1delta.io/llms.txt · every endpoint: https://docs.1delta.io/llms-full.txt

---

### GET /v1/data/lending/pairs

- operationId: `get-lending-pairs`
- docs: https://docs.1delta.io/1delta-api/get-lending-pairs/
- markdown: https://docs.1delta.io/1delta-api/get-lending-pairs.md
- tags: Lending (Data)

Get 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).

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `chainId` | query | string | no | Filter by chain ID See the `ChainId` schema for the full set of supported chains. |
| `lender` | query | string | no | Filter by lender key See the `LenderId` schema for the full set of accepted values. |
| `assetGroupLong` | query | string | no | Filter by collateral asset group |
| `assetGroupShort` | query | string | no | Filter by debt asset group |
| `minApr` | query | number | no | Minimum total APR |
| `minLeverage` | query | number | no | Minimum max leverage |
| `minLiquidityUsd` | query | number | no | Minimum liquidity in USD |
| `includeIlliquid` | query | boolean | no | Keep pairs whose collateral leg has no remaining supply capacity (un-openable at any size). Off by default. |
| `sortBy` | query | "aprTotal" \| "maxLeverage" \| "totalDepositsUsdLong" \| "totalDebtUsdShort" | no | Sort field |
| `sortDir` | query | "asc" \| "desc" | no | Sort direction |
| `start` | query | integer | no | Pagination start index |
| `count` | query | integer | no | Page size |

**Response `200`** — Pair data

| Field | Type | Description |
| --- | --- | --- |
| `success` | true |  |
| `data` | object |  |
| `data.start` | integer |  |
| `data.count` | integer | Number of entries in `items`. |
| `data.items` | object[] | The result set for this response. |
| `data.items[].chainId` | string | EVM chain id, as a decimal string. See the `ChainId` schema. |
| `data.items[].lender` | string | Protocol identifier. See the `LenderId` schema. |
| `data.items[].marketLongUid` | string | Market UID of the collateral side |
| `data.items[].marketShortUid` | string | Market UID of the debt side |
| `data.items[].marketNameLong` | string | Display 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[].marketNameShort` | string | Display 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[].curatorNameLong` | string | Curator/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[].curatorNameShort` | string | Curator/brand of the debt (controller) market. Same semantics as curatorNameLong. |
| `data.items[].assetLong` | string | Collateral asset address |
| `data.items[].assetShort` | string | Debt asset address |
| `data.items[].assetGroupLong` | string |  |
| `data.items[].assetGroupShort` | string |  |
| `data.items[].symbolLong` | string | Collateral token symbol |
| `data.items[].nameLong` | string | Collateral token name |
| `data.items[].symbolShort` | string | Debt token symbol |
| `data.items[].nameShort` | string | Debt token name |
| `data.items[].collateralFactorLong` | number | Liquidation collateral factor for the long side |
| `data.items[].borrowCollateralFactorLong` | number | Borrow-adjusted collateral factor for the long side |
| `data.items[].borrowFactorLong` | number | Borrow factor for the long side |
| `data.items[].collateralDisabledLong` | boolean | Whether collateral is disabled for the long asset |
| `data.items[].debtDisabledLong` | boolean | Whether debt is disabled for the long asset |
| `data.items[].collateralFactorShort` | number | Liquidation collateral factor for the short side |
| `data.items[].borrowCollateralFactorShort` | number | Borrow-adjusted collateral factor for the short side |
| `data.items[].borrowFactorShort` | number | Borrow factor for the short side |
| `data.items[].collateralDisabledShort` | boolean | Whether collateral is disabled for the short asset |
| `data.items[].debtDisabledShort` | boolean | Whether debt is disabled for the short asset |
| `data.items[].eModeConfigId` | string | E-mode configuration ID |
| `data.items[].eMode` | string | E-mode category |
| `data.items[].aprBase` | number | Base APR (deposit - borrow + intrinsic, before rewards) |
| `data.items[].aprTotal` | number | Total APR (base + rewards) |
| `data.items[].maxLeverage` | number | Highest leverage multiple reachable in this market. |
| `data.items[].ltv` | number | Loan-to-value ratio (0-1) |
| `data.items[].depositRateLong` | number |  |
| `data.items[].variableBorrowRateShort` | number |  |
| `data.items[].intrinsicYieldLong` | number |  |
| `data.items[].intrinsicYieldShort` | number |  |
| `data.items[].variableBorrowDisabledShort` | boolean | True when the debt (short) market is a Lista DAO brokered market — it cannot be looped at a variable rate, only at one of the fixed terms in `termsShort`. `variableBorrowRateShort` is `0`/undefined for such pairs. |
| `data.items[].termsShort` | object[] | Fixed-term rate card for the debt (short) side when it is a Lista DAO brokered market. Each entry is one loop option — see the per-term net-APR recipe. `null`/empty for regular variable-rate pairs. For Term Finance an empty card means "not borrowable right now" rather than "no offers" — read `fixedTerm.auction` for why. |
| `data.items[].termsShort[].termId` | integer | Term identifier — MEANING IS LENDER-SPECIFIC. Exactly and TermMax: the pool/market unix MATURITY timestamp. Lista: the broker-defined product id. Teller: the duration in seconds (rolling term). Midnight and Term Finance: `0`, a placeholder (single maturity per market, so the id carries no information). Pass to `/v1/actions/lending/borrow?termId=…`. Numeric on-chain; some upstream feeds serialize it as a string — coerce with `Number()` when comparing. |
| `data.items[].termsShort[].depositApr` | number | Annualised fixed LEND rate at this maturity, in percent (Exactly only — its fixed pools quote both sides). |
| `data.items[].termsShort[].available` | number | Borrowable liquidity at this maturity in loan-token human units (Exactly only). |
| `data.items[].termsShort[].durationDays` | number | How long the position is locked at the fixed rate, in days (e.g. 7, 14, 30). |
| `data.items[].termsShort[].durationSecs` | number | Term duration in seconds (raw on-chain value). |
| `data.items[].termsShort[].apr` | number | Annualised borrow APR for this term, in **percent** (e.g. `3.85` = 3.85%). Same unit as `variableBorrowRate` / `stableBorrowRate`. For order-book markets (Midnight) this is the 0-notional top-of-book (cheapest) rate — see `aprAtAmount` for the size-weighted rate. |
| `data.items[].termsShort[].aprAtAmount` | number | Size-weighted (VWAP) borrow APR % at the supplied debt notional, for order-book fixed-term markets (Morpho Midnight): the borrow book filled cheapest-first, `(Σ filledᵢ·aprᵢ)/amount`. Present only when an amount is supplied AND the term carries an order-book `ladder`; broker rate cards (Lista, single flat rate) omit it and `apr` already applies at any size. |
| `data.items[].termsShort[].fillable` | number | Total loan-token depth in this term's order book — the maximum borrow openable at this maturity. Present only for order-book terms with an amount supplied. |
| `data.items[].termsShort[].capped` | boolean | True when the supplied debt notional exceeds `fillable` — the book can't fully fund the borrow at this maturity (`aprAtAmount` is then the drain-the-book VWAP). |
| `data.items[].termsShort[].ladder` | object[] | Order-book borrow ladder (best-borrow first) for order-book fixed-term markets (Midnight). Only serialized when `depth=true` (bulky). `aprAtAmount` is the pre-computed size-weighted rate; use this to re-derive it at any amount. |
| `data.items[].termsShort[].ladder[].apr` | number | Annualised borrow rate at this tier (%). |
| `data.items[].termsShort[].ladder[].units` | string | Credit/debt units at this tier (raw). |
| `data.items[].termsShort[].ladder[].assets` | number | Loan-token size available at this tier. |
| `data.items[].fixedTerm` | object | Fixed-term descriptor for this pair's lender, joined by lender key. Absent on variable-rate lenders. **For Term Finance (`model: "term"`), gate the borrow/loop CTA on `fixedTerm.auction.canBorrow`**: origination only happens inside scheduled sealed-bid auction rounds and most repos sit between rounds, so a pair can carry a maturity, an LTV and a rate and still be impossible to borrow. Note also that `aprBase`/`aprTotal` on such a pair are computed against a `variableBorrowRate` of 0 and therefore read as an enormous leveraged yield with a free debt leg — show them as indicative, not obtainable, whenever `canBorrow` is false. |
| `data.items[].fixedTerm.model` | "lista" \| "midnight" \| "term" \| "exactly" \| "teller" \| "termmax" | Underlying fixed-term protocol shape. |
| `data.items[].fixedTerm.maturity` | integer | Single fixed calendar maturity, unix seconds. Absent for rolling-duration menus (Lista) and multi-maturity markets (Exactly — the menu lives on `terms[]`). |
| `data.items[].fixedTerm.fees` | object | Market-level fees: `continuousFeeApr` (%/yr lender-side haircut, Midnight), `settlementFee` (fraction at the current TTM, Midnight), `latePenaltyApr` (%/yr on overdue debt, Exactly), `originationFeePercent` (upfront % of principal, Teller). Empty for lenders without them. |
| `data.items[].fixedTerm.earlyRepay` | object | Early-repayment policy: `{ kind: "none" \| "penalty" \| "discount" }`. `none` = exit any time at market price; `penalty` = per-loan penalty (amount is position-level); `discount` = repaying early costs LESS than face value (Exactly). |
| `data.items[].fixedTerm.provider` | object | Who fronts the term: `{ kind: "broker" \| "orderbook" \| "auction" \| "pool", address? }`. `auction` markets carry the `auction` window below and can only be borrowed inside a round. |
| `data.items[].fixedTerm.auction` | object | Origination window for a fixed-term market whose terms are only obtainable during a bounded round rather than continuously — Term Finance (`fixedTerm.provider.kind = "auction"`). Served on `fixedTerm.auction`; ABSENT on lenders whose terms are continuously available, and absent is NOT the same as `closed`. This is the difference between "the rate card is empty right now" and "this market cannot be borrowed at all": between rounds a Term repo still has a maturity, collateral params and a last-cleared rate, but nothing can be borrowed. Most repos are between rounds at any given time. |
| `data.items[].fixedTerm.auction.status` | "upcoming" \| "open" \| "revealing" \| "closed" | `upcoming` — a round is listed but not yet accepting submissions. `open` — accepting sealed bids/offers. `revealing` — bidding shut, sealed prices revealing and the round clearing. `closed` — no round is listed. Snapshot at fetch time; re-derive from the timestamps against the current clock when reading a cached response. |
| `data.items[].fixedTerm.auction.canBorrow` | boolean | Can a NEW borrow be opened right now? **Gate the borrow CTA on this**, not on `status` and not on the presence of a rate — it stays correct if more statuses are added. True only inside an open round: Term borrow origination is a sealed bid, so there is no other entry point. |
| `data.items[].fixedTerm.auction.canLend` | boolean | Can a NEW lend position be opened right now? Deliberately independent of `canBorrow` — the primary auction is only one of two lend surfaces, and buying repo tokens on the secondary market works between rounds. A closed round therefore leaves the market **lend-only**, not inert; greying out the whole market would be wrong. |
| `data.items[].fixedTerm.auction.secondsUntilClose` | integer | Seconds until submissions close (`revealTime − now`). Absent unless a round is open. A snapshot — for a live countdown derive from `revealTime`, since responses are cached. |
| `data.items[].fixedTerm.auction.implications` | string[] | Ready-to-display consequences of this market's origination model, most important first (same convention as `params.market.teller.implications`). Auction mechanics are unusual enough that showing only a rate misleads. |
| `data.items[].fixedTerm.auction.id` | string | Auction round id. Absent when `status: "closed"`. |
| `data.items[].fixedTerm.auction.startTime` | integer | Submissions open, unix seconds. Absent when closed. |
| `data.items[].fixedTerm.auction.revealTime` | integer | Submissions CLOSE and sealed prices begin revealing, unix seconds — **the deadline to act**. Absent when closed. |
| `data.items[].fixedTerm.auction.endTime` | integer | Round clears, unix seconds. Equal to `revealTime` on current deployments. Absent when closed. |
| `data.items[].fixedTerm.auction.minBorrowAmount` | string | Minimum bid (borrow) size for this round, loan-token BASE units. A real floor (e.g. `"1000000000"` = 1000 USDC) — a smaller amount cannot be submitted at all, so validate before building the action rather than surfacing a failed transaction. |
| `data.items[].fixedTerm.auction.minLendAmount` | string | Minimum offer (lend) size for this round, loan-token BASE units. |
| `data.items[].rewardAprLong` | number | Total reward APR on the collateral side |
| `data.items[].rewardAprShort` | number | Total reward APR on the debt side |
| `data.items[].rewardsLong` | object[] | Reward programs for the collateral side |
| `data.items[].rewardsShort` | object[] | Reward programs for the debt side |
| `data.items[].totalDepositsLong` | number | Total deposits in token units (long side) |
| `data.items[].totalDebtLong` | number | Total debt in token units (long side) |
| `data.items[].totalLiquidityLong` | number | Total liquidity in token units (long side) |
| `data.items[].totalDepositsShort` | number | Total deposits in token units (short side) |
| `data.items[].totalDebtShort` | number | Total debt in token units (short side) |
| `data.items[].totalLiquidityShort` | number | Total liquidity in token units (short side) |
| `data.items[].totalDepositsUsdLong` | number |  |
| `data.items[].totalDebtUsdLong` | number |  |
| `data.items[].totalLiquidityUsdLong` | number |  |
| `data.items[].totalDepositsUsdShort` | number |  |
| `data.items[].totalDebtUsdShort` | number |  |
| `data.items[].totalLiquidityUsdShort` | number |  |
| `data.items[].borrowLiquidityShort` | number | Available borrow liquidity (debt side) in token units |
| `data.items[].withdrawLiquidityLong` | number | Available withdraw liquidity (collateral side) in token units |
| `data.items[].depositableLong` | number | Remaining deposit capacity (collateral side) in token units |
| `data.items[].utilizationLong` | number |  |
| `data.items[].utilizationShort` | number |  |
| `data.items[].underlyingInfoLong` | object | Collateral asset metadata including token info, market prices, and oracle prices |
| `data.items[].underlyingInfoLong.asset` | object | Token metadata (address, symbol, name, decimals, logoURI, assetGroup) |
| `data.items[].underlyingInfoLong.prices` | object | Market prices (priceUsd, priceUsd24h, priceChange24h) |
| `data.items[].underlyingInfoLong.oraclePrice` | object | On-chain oracle prices (oraclePrice, oraclePriceUsd) |
| `data.items[].underlyingInfoShort` | object | Debt asset metadata including token info, market prices, and oracle prices |
| `data.items[].underlyingInfoShort.asset` | object | Token metadata (address, symbol, name, decimals, logoURI, assetGroup) |
| `data.items[].underlyingInfoShort.prices` | object | Market prices (priceUsd, priceUsd24h, priceChange24h) |
| `data.items[].underlyingInfoShort.oraclePrice` | object | On-chain oracle prices (oraclePrice, oraclePriceUsd) |
| `actions` | null |  |

**Example response**

```json
{
  "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,
        "aprTotal": 1,
        "maxLeverage": 1,
        "ltv": 1,
        "depositRateLong": 1,
        "variableBorrowRateShort": 1,
        "intrinsicYieldLong": 1,
        "intrinsicYieldShort": 1,
        "variableBorrowDisabledShort": true,
        "termsShort": [
          {
            "termId": 2,
            "depositApr": 1,
            "available": 1,
            "durationDays": 7,
            "durationSecs": 604800,
            "apr": 3.85,
            "aprAtAmount": 1,
            "fillable": 1,
            "capped": true,
            "ladder": [
              {
                "apr": 1,
                "units": "string",
                "assets": 1
              }
            ]
          }
        ],
        "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,
        "rewardAprShort": 1,
        "rewardsLong": [
          {}
        ],
        "rewardsShort": [
          {}
        ],
        "totalDepositsLong": 1,
        "totalDebtLong": 1,
        "totalLiquidityLong": 1,
        "totalDepositsShort": 1,
        "totalDebtShort": 1,
        "totalLiquidityShort": 1,
        "totalDepositsUsdLong": 1,
        "totalDebtUsdLong": 1,
        "totalLiquidityUsdLong": 1,
        "totalDepositsUsdShort": 1,
        "totalDebtUsdShort": 1,
        "totalLiquidityUsdShort": 1,
        "borrowLiquidityShort": 1,
        "withdrawLiquidityLong": 1,
        "depositableLong": 1,
        "utilizationLong": 1,
        "utilizationShort": 1,
        "underlyingInfoLong": {
          "asset": {},
          "prices": {},
          "oraclePrice": {}
        },
        "underlyingInfoShort": {
          "asset": {},
          "prices": {},
          "oraclePrice": {}
        }
      }
    ]
  }
}
```

**Response `400`** — Validation error

**Response `429`** — Rate limited. Unauthenticated callers share a per-IP budget; send an `x-api-key` header to lift it. Retry with exponential backoff.

**Response `500`** — Unexpected server error. Safe to retry with backoff.

**Response `502`** — An upstream data source or protocol origin failed (`error.code` is `ORIGIN_FAILED`). `error.details` carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.