Skip to main content

CloseRangeResult

Max closeable amount. Bounded by min(collateral, debt).

chainIdstring
lenderstring
marketLongUidstring

Market UID of the collateral side

marketShortUidstring

Market UID of the debt side

marketNameLongstringnullable

Display name of the collateral market/vault (e.g. the Euler eVault name). Disambiguates rows that share the collateral/debt token symbols and lender.

marketNameShortstringnullable

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.

curatorNameLongstringnullable

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.

curatorNameShortstringnullable

Curator/brand of the debt (controller) market. Same semantics as curatorNameLong.

assetLongstring

Collateral asset address

assetShortstring

Debt asset address

assetGroupLongstring
assetGroupShortstring
symbolLongstring

Collateral token symbol

nameLongstring

Collateral token name

symbolShortstring

Debt token symbol

nameShortstring

Debt token name

collateralFactorLongnumber

Liquidation collateral factor for the long side

Example: 0.94
borrowCollateralFactorLongnumber

Borrow-adjusted collateral factor for the long side

Example: 0.92
borrowFactorLongnumber

Borrow factor for the long side

Example: 1
collateralDisabledLongboolean

Whether collateral is disabled for the long asset

debtDisabledLongboolean

Whether debt is disabled for the long asset

collateralFactorShortnumber

Liquidation collateral factor for the short side

Example: 0.94
borrowCollateralFactorShortnumber

Borrow-adjusted collateral factor for the short side

Example: 0.92
borrowFactorShortnumber

Borrow factor for the short side

Example: 1
collateralDisabledShortboolean

Whether collateral is disabled for the short asset

debtDisabledShortboolean

Whether debt is disabled for the short asset

eModeConfigIdstring

E-mode configuration ID

eModestring

E-mode category

aprBasenumber

Base APR (deposit - borrow + intrinsic, before rewards)

aprTotalnumber

Total APR (base + rewards)

maxLeveragenumber
ltvnumber

Loan-to-value ratio (0-1)

depositRateLongnumber
variableBorrowRateShortnumber
intrinsicYieldLongnumber
intrinsicYieldShortnumber
variableBorrowDisabledShortbooleannullable

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.

termsShort object[]nullable

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.

  • 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. For order-book markets (Midnight) this is the 0-notional top-of-book (cheapest) rate — see aprAtAmount for the size-weighted rate.

    Example: 3.85
    aprAtAmountnumbernullable

    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.

    fillablenumbernullable

    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.

    cappedbooleannullable

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

    ladder object[]nullable

    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.

  • Array [
  • aprnumber

    Annualised borrow rate at this tier (%).

    unitsstring

    Credit/debt units at this tier (raw).

    assetsnumber

    Loan-token size available at this tier.

  • ]
  • ]
  • rewardAprLongnumber

    Total reward APR on the collateral side

    rewardAprShortnumber

    Total reward APR on the debt side

    rewardsLongobject[]nullable

    Reward programs for the collateral side

    rewardsShortobject[]nullable

    Reward programs for the debt side

    totalDepositsLongnumber

    Total deposits in token units (long side)

    totalDebtLongnumber

    Total debt in token units (long side)

    totalLiquidityLongnumber

    Total liquidity in token units (long side)

    totalDepositsShortnumber

    Total deposits in token units (short side)

    totalDebtShortnumber

    Total debt in token units (short side)

    totalLiquidityShortnumber

    Total liquidity in token units (short side)

    totalDepositsUsdLongnumber
    totalDebtUsdLongnumber
    totalLiquidityUsdLongnumber
    totalDepositsUsdShortnumber
    totalDebtUsdShortnumber
    totalLiquidityUsdShortnumber
    borrowLiquidityShortnumber

    Available borrow liquidity (debt side) in token units

    withdrawLiquidityLongnumber

    Available withdraw liquidity (collateral side) in token units

    depositableLongnumber

    Remaining deposit capacity (collateral side) in token units

    utilizationLongnumber
    utilizationShortnumber
    underlyingInfoLong object

    Collateral asset metadata including token info, market prices, and oracle prices

    asset object

    Token metadata (address, symbol, name, decimals, logoURI, assetGroup)

    property name*any

    Token metadata (address, symbol, name, decimals, logoURI, assetGroup)

    prices object

    Market prices (priceUsd, priceUsd24h, priceChange24h)

    property name*any

    Market prices (priceUsd, priceUsd24h, priceChange24h)

    oraclePrice object

    On-chain oracle prices (oraclePrice, oraclePriceUsd)

    property name*any

    On-chain oracle prices (oraclePrice, oraclePriceUsd)

    underlyingInfoShort object

    Debt asset metadata including token info, market prices, and oracle prices

    asset object

    Token metadata (address, symbol, name, decimals, logoURI, assetGroup)

    property name*any

    Token metadata (address, symbol, name, decimals, logoURI, assetGroup)

    prices object

    Market prices (priceUsd, priceUsd24h, priceChange24h)

    property name*any

    Market prices (priceUsd, priceUsd24h, priceChange24h)

    oraclePrice object

    On-chain oracle prices (oraclePrice, oraclePriceUsd)

    property name*any

    On-chain oracle prices (oraclePrice, oraclePriceUsd)

    amountInnumberrequired

    Max collateral to withdraw (in long asset units)

    Example: 3.5
    amountOutnumberrequired

    Max debt to repay (in short asset units)

    Example: 4
    amountUSDnumberrequired

    Max closeable amount in USD (min of collateral and debt)

    Example: 8000
    denominationstringrequired

    Which side is the base denomination

    Possible values: [exactInput, exactOutput]

    CloseRangeResult
    {
    "amountIn": 3.5,
    "amountOut": 4,
    "amountUSD": 8000,
    "denomination": "exactInput",
    "chainId": "string",
    "lender": "string",
    "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": 0,
    "aprTotal": 0,
    "maxLeverage": 0,
    "ltv": 0,
    "depositRateLong": 0,
    "variableBorrowRateShort": 0,
    "intrinsicYieldLong": 0,
    "intrinsicYieldShort": 0,
    "variableBorrowDisabledShort": true,
    "termsShort": [
    {
    "termId": 2,
    "durationDays": 7,
    "durationSecs": 604800,
    "apr": 3.85,
    "aprAtAmount": 0,
    "fillable": 0,
    "capped": true,
    "ladder": [
    {
    "apr": 0,
    "units": "string",
    "assets": 0
    }
    ]
    }
    ],
    "rewardAprLong": 0,
    "rewardAprShort": 0,
    "rewardsLong": [
    {}
    ],
    "rewardsShort": [
    {}
    ],
    "totalDepositsLong": 0,
    "totalDebtLong": 0,
    "totalLiquidityLong": 0,
    "totalDepositsShort": 0,
    "totalDebtShort": 0,
    "totalLiquidityShort": 0,
    "totalDepositsUsdLong": 0,
    "totalDebtUsdLong": 0,
    "totalLiquidityUsdLong": 0,
    "totalDepositsUsdShort": 0,
    "totalDebtUsdShort": 0,
    "totalLiquidityUsdShort": 0,
    "borrowLiquidityShort": 0,
    "withdrawLiquidityLong": 0,
    "depositableLong": 0,
    "utilizationLong": 0,
    "utilizationShort": 0,
    "underlyingInfoLong": {
    "asset": {},
    "prices": {},
    "oraclePrice": {}
    },
    "underlyingInfoShort": {
    "asset": {},
    "prices": {},
    "oraclePrice": {}
    }
    }