Skip to main content
GET
Returns the market’s insurance fund: what it holds and has paid out, whether it covers this market, and what the market has booked for it but not yet swept. It also reports the losses the market has taken, and states in words when the reserve is drawn. The fund reports only what it paid. Read marketBadDebt beside it, because a fund that covered nothing and a market that never took a loss otherwise look the same.

When the reserve pays

Where the market draws on it, the reserve absorbs a shortfall ahead of the liquidity providers, but only up to what it holds. A draw larger than the balance pays the balance, and the pool books the rest. A fund whose owner has withdrawn this market’s authorization pays nothing and blocks nothing, so the whole loss lands on the pool. The market draws on the reserve on every first settlement that retains less than the record’s claim, whether through the liquidation router, a batch settlement or the auction venue’s closing fill. It also draws on it on the write-off after the 7-day window, and for the residual of an instant whole-position realization. generation.settlementDrawsReserve reports this as true, or null when it could not be read. A later recovery on a record the reserve advanced against makes the pool whole on the record’s claim first. Only what is left above the claim repays the reserve. disclosure states all of this in words. The reserve is funded two ways. Sweep Protocol Fees deposits the insurance-fund rate’s share of interest, and Top Up Insurance Fund lets any wallet add capital. Apart from coverage paid to an authorized market, only the fund owner can take money out, through Withdraw from Insurance Fund. That withdrawal is announced 7 days ahead and executes within the following 7 days, for the announced amount and destination only, so every provider can see the first-loss buffer leaving before it does. withdrawalNotice reports what is announced.
An authorized address draws coverage that is paid to it directly, so who is authorized matters as much as the withdrawal notice. A new authorization is announced 7 days ahead and the fund owner activates it within the following 7 days. Until then the address cannot draw. Removing an authorization takes effect at once. reserveAccess lists every address other than this market that the fund authorizes and every announcement still pending, so a draw outside the notice never goes unseen. An authorized plain wallet, not a market contract, is called out in reserveAccess.warning.

Path Parameters

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

Response Fields

object
Reading this endpoint also records top-ups nobody recorded through Record Insurance Top-Up. It looks back 50,000 blocks, runs at most once a minute per market, and skips deposits from markets the fund authorizes, which are protocol-fee sweeps.

Error Codes