Skip to main content

Debt swap

GET 

/v1/actions/loop/debt-swap

Swap debt between different borrow positions. Identify the repay-side debt market with marketUidIn and borrow-side with marketUidOut. Omit account for quote-only (returns data.quotes with price deltas). Include account to build full transaction calldata (populates actions with alternatives, transactions, and permissions).

Response actions fields (when account is provided):

  • alternatives: DEX aggregator swap transactions sorted best-output-first. Pick one to execute.
  • transactions: Empty for debt-swap operations (no setup needed).
  • permissions: Lender borrow and withdrawal delegations (targeting the lending protocol contract). Only missing delegations are returned. Execute these first.
Plain-text reference — GET /v1/actions/loop/debt-swap

Parameters

ParameterInTypeRequiredDescription
routequeryauto, bundler3, native, composer, proxynoWhich assembly to use, for lenders that have more than one. Morpho Blue only today.
  • (omitted) — auto: prefer the protocol’s own tooling and fall back to the composer for anything it cannot express (a cross-market pair, a margin paid in a foreign asset, an EXACT_OUTPUT close, a chain with no bundler3 or no swap adapter).
  • bundler3 / native — force Morpho’s bundler3. A request it cannot serve becomes an ERROR instead of silently falling back, which is what makes the route testable.
  • composer / proxy — force the 1delta composer.

The default matters: the bundler3 route asks for setAuthorization(GeneralAdapter1), Morpho’s own audited adapter, where the composer route asks for a standing grant on ours. | | marketUidIn | query | string | yes | Market identifier for input side (lender:chainId:address). | | marketUidOut | query | string | yes | Market identifier for output side (lender:chainId:address). | | slippage | query | number | yes | Slippage tolerance (basis points) | | account | query | string | no | Account address. Include to build transaction, omit for quote-only. | | amount | query | string | yes | Amount in wei | | tradeType | query | 0, 1 | no | Trade type | | irModeIn | query | 0, 1, 2 | no | Interest rate mode for repaid debt | | irModeOut | query | 0, 1, 2 | no | Interest rate mode for new debt | | usePendleMintRedeem | query | boolean | no | Use Pendle mint/redeem | | isAll | query | boolean | no | Repay full debt | | accountId | query | string | no | Account ID (Init Capital, Euler V2, Dolomite). Dolomite: a uint256 account number, or iso:<marketId>:<n> for a position inside an isolation-mode vault (dGM, dsavETH, dGMX …); borrow positions on those need n >= 100, account 0 is the supply-only vault balance. |

Response 200

FieldTypeDescription
successTrue
dataobjectInformational data (quotes, simulation results, etc.)
data.lenderstringProtocol identifier
data.quotesobject[]Candidate routes, best output first. Execute exactly one.
data.quotes[].deltasobject
data.quotes[].deltas.aggregatorstringAggregator source
data.quotes[].deltas.tradeInputnumberTrade input amount
data.quotes[].deltas.tradeOutputnumberTrade output amount
data.quotes[].deltas.deltasobjectBalance deltas
data.quotes[].rateImpactobject[]Projected interest-rate impact per market for THIS quote (its own trade amounts). Omitted if IRM data is unavailable.
data.quotes[].rateImpact[].marketUidstringMarket identifier (format: lender:chainId:address)
data.quotes[].rateImpact[].utilizationobjectA current/projected pair for a single rate metric.
data.quotes[].rateImpact[].borrowRateobjectA current/projected pair for a single rate metric.
data.quotes[].rateImpact[].depositRateobjectA current/projected pair for a single rate metric.
data.quotes[].rateImpact[].intrinsicYieldnumberThe asset's own yield in percent (LST staking yield, RWA NAV growth, a Gearbox quota rate as a negative), size-invariant, ADDED to both sides: earned on a deposit, forgone on a borrow. Absent when the lender meta was not readable when the response was built — never defaulted to 0 in that case.
data.quotes[].rateImpact[].depositRewardAprnumberSum of reward-stream APRs (%) on the deposit side. Absent with intrinsicYield.
data.quotes[].rateImpact[].borrowRewardAprnumberSum of reward-stream APRs (%) rebated on the borrow side. Absent with intrinsicYield.
data.quotes[].rateImpact[].effectiveDepositRateobjectA current/projected pair for a single rate metric.
data.quotes[].rateImpact[].effectiveBorrowRateobjectA current/projected pair for a single rate metric.
data.quotes[].rateImpact[].flatbooleanTrue when the market has no utilization curve to shift (Morpho Blue collateral, a fixed-rate broker): current === projected, taken from the published rates, and utilization is NaN. Present so the leg is not silently missing from a position preview.
data.quotes[].netAprobjectThe trade's carry at post-trade rates — the position net APR. annualUsd is the change in yearly carry the trade causes (deposit/withdraw legs earn, borrow/repay legs cost); aprPct puts it on the net equity the trade moves (the margin on an open) and is null when that equity is not positive (a pure leverage step, a swap). The bare figures exclude rewards; *Total include them.
data.quotes[].netApr.annualUsdnumber
data.quotes[].netApr.annualUsdTotalnumber
data.quotes[].netApr.equityUsdnumber
data.quotes[].netApr.aprPctnumber
data.quotes[].netApr.aprPctTotalnumber
data.quotes[].netApr.legsobject[]
data.quotes[].economicsobjectTHIS route's trade economics — TradeEconomics on an open, CloseEconomics on a close. See the schema for the discipline.
data.quotes[].economics.notionalUsdobjectThe position this route creates, at the oracle. equity is the margin the user brings (0 on a pure leverage step).
data.quotes[].economics.entryCostUsdobjectDay-0 cost of getting in. slippage = swap input at the oracle − swap output at the oracle (floored at 0; slippageBp keeps the sign). gas is null when it could not be priced.
data.quotes[].economics.slippageBpnumberSigned swap-vs-oracle, BP of the swap input. Negative = the route costs money.
data.quotes[].economics.entryCostBpnumberentryCostUsd.total over the DEBT notional, BP.
data.quotes[].economics.feesobject[]
data.quotes[].economics.carryPerDayUsdobjectThe trade's carry per day at PROJECTED rates — what it earns after its own borrow has moved the pool. total counts incentives, base does not. With an account, the repricing of the existing book is netted out.
data.quotes[].economics.carryBasisprojected, sticker, none
data.quotes[].economics.breakEvenDaysobjectentryCostUsd.total / carryPerDayUsd. Null when the carry is not positive (never pays for itself — see notes) or unknown.
data.quotes[].economics.roundTripDaysobject(entry + exit cost) / carry. closeQuoted says whether the exit was PRICED (a real close quote) or ASSUMED symmetric to the entry (the default today). Null on a debt that cannot be repaid early (Midnight): the round trip is at maturity, not before.
data.quotes[].economics.horizonDaysnumberDays until the trade's clock runs out. Null = perpetual.
data.quotes[].economics.horizonobject
data.quotes[].economics.breaksEvenBeforeHorizonboolean

Request​

Responses​

Quote or full build response