Skip to main content
POST
Builds haltPrices on the market’s price oracle for a guardian, or liftPriceHalt for the oracle owner, and confirms either once mined. action picks which. The endpoint never submits the transaction.
A halt stops every price-dependent path on the market for as long as it runs: no loan opens, no draw, no collateral withdrawal against debt, and no liquidation. Loans the pool is losing money on cannot be realized until the halt ends or the owner lifts it. Repayment, closure and exits stay open. Halt only on a decision the lender of record stands behind, and revoke a guardian that halts without cause.
A halt lasts durationSeconds, at most 24 hours, and ends by itself. The oracle owner can end it earlier with lift, which records the halt as ended at that moment. A new halt can start only 24 hours after the previous one ended, either way. While a halt runs the oracle refuses every attestation with PriceHalted, pushed or signed, and isPriceStale answers true on every price source, the fixed price included. The guardian is any wallet holding GUARDIAN_ROLE on the market, named with Set Access Role as MARKET_GUARDIAN. The oracle reads the role off the market, so a revocation there ends the guardian’s standing here at once. Get Oracle Halt reads the state without building anything.

Path Parameters

string
required
The market’s record ID, as id on List Markets, not its contract address. See Market IDs.

Body Parameters

string
required
halt or lift. Required on the confirm call too, where it selects the function and event the receipt must carry.
integer
halt only. How long the halt runs, 1 to 86400 seconds. Required when building a halt.
string
halt only. The guardian that will sign. When sent, the oracle is asked whether it recognizes the wallet as a guardian, and the build is refused with NOT_GUARDIAN when it does not. Omit it and no role check runs: a wallet without the role has its transaction reverted on chain.
string
Hash of the mined transaction. Send it with the same action to confirm. Omit it to receive the calldata.

Calldata Response

object

Confirmed Response

The confirm call verifies that the transaction targeted the oracle, called the function action names, and emitted PricesHalted or PriceHaltLifted on it. It then clears the cached oracle status, so the next Get Oracle Status reflects the change, and writes the audit log entry LENDING_ORACLE_HALTED or LENDING_ORACLE_HALT_LIFTED.
object

Error Codes

Confirming with txHash can also return any transaction verification error.