Skip to main content

Close a trove

GET 
/v1/actions/liquity/close

Close a trove: burns the FULL live entireDebt (incl. per-block interest accrual — keep a small stable buffer above any quote) from the sender and returns all collateral plus the gas compensation. Equivalent to lending/repay with isAll=true.

Liquity V2 family is a pooled CDP — one branch per collateral, troves = sub-accounts (troveId, the sub-account id from user data), user-set adjustable interest rates, and a per-branch Stability Pool as the stable-token earn side. Deployments: LIQUITY_V2 (Ethereum) + friendly forks (USDAF, FELIX, NERITE, QUILL, ENOSYS_LOANS, SONETA, EBISU) — all share this surface; per-fork parameters (min debt, rate bounds, gas compensation) come from metadata.

Standard lending actions cover the day-to-day ops for a <DEPLOYMENT>_<chainId>_<COLL_INDEX> market key:

  • stable-token deposit/withdraw → Stability Pool (earn; isAll withdraw uses the protocol sentinel)
  • collateral deposit/withdraw → addColl/withdrawColl (pass troveId)
  • borrow → withdrawBold (pass troveId; upfront-fee guard quoted automatically, override with maxUpfrontFee)
  • repay → repayBold clamped to entireDebt − minDebt; isAll=true routes to closeTrove (burns the full live debt from the wallet, returns collateral + the WETH gas compensation)

The endpoints in this section handle the trove lifecycle ops that need more than one amount or no amount at all. Fees to know: the upfront borrowing fee (≈7 days of average branch interest on any debt increase) and the premature rate-adjustment fee (same formula on the WHOLE debt when changing the rate within the cooldown). Repaying itself is always free.

Request​

Responses​