Skip to main content

Close margin position

GET 

/v1/actions/loop/close

Close a leveraged position. Identify the collateral market with marketUidIn and debt market 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 close operations (no setup needed).
  • permissions: Lender withdrawal delegations (targeting the lending protocol contract). Only missing delegations are returned. Execute these first.

Lista DAO fixed-term (brokered) markets: when marketUidOut is brokered, pass loanId to select which broker loan the repay leg pays down (or the type(uint128).max sentinel for the flexible position). The collateral withdraw leg is handled automatically (routed through the market's collateralProvider when set, e.g. slisBNB).

Exit economics (data.quotes[i].economics, best route mirrored at data.economics): a CloseEconomics block per route — exitCostUsd (swap slippage vs the oracle, exit fees off the debt leg's term sheet such as an early-repay penalty, gas over the bundle), carryForgonePerDayUsd (what the closed slice was earning, at the projected rates the repay moves the pool to) and daysOfCarry (the exit cost in days of that carry). Null + a notes line for anything that could not be read.

Plain-text reference — GET /v1/actions/loop/close

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 (0=EXACT_INPUT, 1=EXACT_OUTPUT) | | irModeOut | query | 0, 1, 2 | no | Interest rate mode for debt | | usePendleMintRedeem | query | boolean | no | Use Pendle mint/redeem | | isAll | query | boolean | no | Repay full debt | | loanId | query | string | no | Lista DAO fixed-term (brokered) debt markets only. Identifies which loan the close repays on the loop's repay leg: the loan's loanId (broker posId) from the user-positions response, or the type(uint128).max sentinel (340282366920938463463374607431768211455) for the flexible/dynamic position. Required when marketUidOut is a brokered market; ignored otherwise. | | 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