Skip to main content
GET
Returns the market’s liquidation records that are settled or written off, newest first. Each router record is checked against the router, so the list also shows collateral a settlement left behind on the router, and whether Reopen Liquidation can still bring it back. Before answering, the endpoint re-reads each record from the chain and corrects what the chain contradicts, in the response and in the stored record: the seized collateral and the debt from the market’s own record, the seizure time and transaction, the auction that carried it, the settlement transaction and its block time, and a stored usdcProceeds that understates what the market’s record settled over. Every instance that holds the market therefore reads the same history, whichever of them confirmed each step. Filter by settlement date with from and to, and add format=csv for the same records as a CSV statement.

Path Parameters

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

Query Parameters

integer
default:"50"
Records to return, from 1 to 200. A larger value is capped at 200, a negative one raised to 1, and zero or a non-number reads as 50.
integer
default:"0"
Records to skip, newest first. Page with offset until hasMore is false.
string
Earliest settlement date, as YYYY-MM-DD (from the start of that day, UTC) or an ISO 8601 timestamp with an offset. A record with no settlement date is filtered on its seizure date. The date must exist on the calendar: 2026-02-30 is refused, never rolled over.
string
Latest settlement date, as YYYY-MM-DD (through the end of that day, UTC) or an ISO 8601 timestamp. Must not be before from.
string
csv returns the records as a CSV file instead of JSON: one row per record, unit-labelled headers, at most the 1000 newest records in the range, with X-Total-Count and X-Truncated headers. limit and offset are ignored. Transaction columns are empty where no transaction is known.

Response Fields

object
The router fields are absent, not false, when the router could not be read and on venue- records. Read collateralStranded only where routerAddress is present. The loss fields from totalDebtAtSeizure on are absent when the market’s record could not be read.

Error Codes

A failed database read answers 500 INTERNAL_ERROR. A failed chain read never fails the request: the fields that depend on it are left out.