> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# List Settled Liquidations
> List closed liquidations with what they realized and any collateral left on the router
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](/endpoints/lending/reopen-liquidation) can still bring it back.
Before answering, the endpoint re-reads each settled record's figure from the market. A record whose stored `usdcProceeds` understates what the market's record settled over is corrected, in the response and in the stored record.
## Path Parameters
Market ID. At most 100 characters.
## Query Parameters
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`.
## Response Fields
Number of records returned.
Ordered by `settledAt`, then `createdAt`, newest first.
Router liquidation ID, or `venue-{marketLiquidationId}` for a record an auction sold in full.
The market's own record ID.
Market ID.
Loan that was liquidated.
Market contract.
Collateral seized at liquidation.
Debt the record claimed.
Collateral token.
Borrower whose loan was liquidated.
`true` when the loan was realized on its expired term rather than on its health.
The Dutch auction that sold some or all of the collateral, or `null`.
Seizure transaction hash, or `chain-adopted` when it could not be located.
`SETTLED` or `WRITTEN_OFF`.
What the market's record settled over, in borrow asset units, where known. A write-off records none.
The transaction that settled, closed or wrote off the record, when known.
ISO 8601 timestamp of that transaction's block, when known.
ISO 8601 timestamp of the seizure.
`router` for a record closed on the router, `venue` for a record an auction sold in full, `null` for a write-off.
Router the record lives on. Present on router records when the router could be read, like the five fields below.
Whether the router has closed its own record. A written-off record usually reads `false`, because the write-off never touches the router.
Collateral still on the router for this record.
Cash the router collected for this record, in borrow asset units.
`true` when the router closed the record with collateral still on it. That collateral can no longer be withdrawn.
`true` when the collateral is stranded and the record collected nothing, which is when [Reopen Liquidation](/endpoints/lending/reopen-liquidation) accepts it.
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.
```bash cURL theme={null}
curl "https://api.trusset.org/lending-external-securities-v2/api/liquidations/{marketId}/settled-liquidations?limit=20" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/lending-external-securities-v2/api/liquidations/${marketId}/settled-liquidations?limit=20`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const toReopen = data.settledLiquidations.filter((l) => l.reopenable === true);
```
```json Response theme={null}
{
"success": true,
"data": {
"settledLiquidations": [
{
"id": "secliq_006",
"liquidationId": "16",
"marketLiquidationId": "16",
"marketId": "clx_secmarket_001",
"loanId": "11",
"marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
"collateralAmount": "90.0",
"debtOwed": "8120.0",
"tokenAddress": "0x9c41e7b2d05f38a61c4e0b7d93a2f15e68c3d7a4",
"borrower": "0x4e1b2c93d07a5f68e3b9d15c02a7f4e6b8d31a90",
"termRealization": false,
"auctionId": null,
"txHash": "0x3a7e19c4d2b85f60e1a94c37b8d02f6e5c13a9b47d80e2f5c6b19a3d74e08c21",
"status": "SETTLED",
"usdcProceeds": "0.0",
"settledTxHash": null,
"createdAt": "2026-07-02T14:05:12.000Z",
"updatedAt": "2026-07-03T08:40:31.000Z",
"settledAt": "2026-07-03T08:40:31.000Z",
"routerAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralRemaining": "90.0",
"proceedsCollected": "0.0",
"routerSettled": true,
"collateralStranded": true,
"reopenable": true,
"settledOn": "router"
},
{
"id": "secliq_004",
"liquidationId": "14",
"marketLiquidationId": "14",
"marketId": "clx_secmarket_001",
"loanId": "7",
"marketAddress": "0x70a0e25c7b768b87e658348b3b577678a173e038",
"collateralAmount": "220.0",
"debtOwed": "21159.2",
"tokenAddress": "0x9c41e7b2d05f38a61c4e0b7d93a2f15e68c3d7a4",
"borrower": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"termRealization": false,
"auctionId": null,
"txHash": "0x9f2c41d8b7e05a3164c2870fbd935e1a4c7802db6135ea9048f7c21b5d3ea41b",
"status": "SETTLED",
"usdcProceeds": "21400.0",
"settledTxHash": "0x2d7c90e14b3a65f8d1e02c7b49f3a86e5d1c04b7f29e38a6c50d1f47b8e92a3c",
"createdAt": "2026-06-14T09:12:00.000Z",
"updatedAt": "2026-06-18T16:02:11.000Z",
"settledAt": "2026-06-18T16:02:00.000Z",
"routerAddress": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
"collateralRemaining": "0.0",
"proceedsCollected": "21400.0",
"routerSettled": true,
"collateralStranded": false,
"reopenable": false,
"settledOn": "router"
}
],
"totalCount": 2
}
}
```
## Error Codes
| Code | HTTP | Cause |
| ------------------- | ----- | ---------------------------------------- |
| `MISSING_MARKET_ID` | `400` | `marketId` is longer than 100 characters |
| `MARKET_NOT_FOUND` | `404` | No market with this ID on your instance |
A failed database read answers `200` with an empty list rather than an error.