Liquidations
List Settled Liquidations
List closed liquidations with what they realized and any collateral left on the router
GET
/
lending-external-securities-v2
/
api
/
liquidations
/
{marketId}
/
settled-liquidations
curl "https://api.trusset.org/lending-external-securities-v2/api/liquidations/{marketId}/settled-liquidations?limit=20" \
-H "X-API-Key: trusset_your_key_here"
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);
{
"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,
"realization": "ROUTER",
"buyer": 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,
"totalDebtAtSeizure": "16240.0",
"principalOwed": "8000.0",
"writtenOffAtSeizure": null,
"seizureReserveCovered": null,
"shortfall": null,
"reserveCovered": null,
"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",
"realization": "ROUTER",
"buyer": null,
"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,
"totalDebtAtSeizure": "42318.4",
"principalOwed": "20900.0",
"writtenOffAtSeizure": null,
"seizureReserveCovered": null,
"shortfall": null,
"reserveCovered": null,
"settledOn": "router"
}
],
"totalCount": 2,
"limit": 50,
"offset": 0,
"hasMore": false
}
}
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 settled record’s figure from the market. A record whose stored
A failed database read answers
usdcProceeds understates what the market’s record settled over is corrected, in the response and in the stored record.
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.Response Fields
object
Show child attributes
Show child attributes
integer
Number of settled and written-off records the market holds, across every page.
integer
The page size applied.
integer
The records skipped.
boolean
true while records beyond this page exist.array
Ordered by
settledAt, then createdAt, then id, newest first.Show child attributes
Show child attributes
string
Router liquidation ID, or
venue-{marketLiquidationId} for a record an auction sold in full.string
The market’s own record ID.
string
Market ID.
string
Loan that was liquidated.
string
Market contract.
string
Collateral seized at liquidation.
string
Debt the record claimed.
string
Collateral token.
string
Borrower whose loan was liquidated.
boolean
true when the loan was realized on its expired term rather than on its health.string
The Dutch auction that sold some or all of the collateral, or
null.string
Seizure transaction hash, or
chain-adopted when it could not be located.string
SETTLED or WRITTEN_OFF.string
How the collateral was realized:
ROUTER, VENUE, or ATOMIC for a sale to the sale recipient at its standing bid, in the liquidation or through Sell Pending Liquidation. null when the record does not state it.string
The sale recipient that bought, lowercased, on an
ATOMIC record. null otherwise.string
What the market’s record settled over, in borrow asset units, where known. A write-off records none.
string
The transaction that settled, closed or wrote off the record, when known.
string
ISO 8601 timestamp of that transaction’s block, when known.
string
ISO 8601 timestamp of the seizure.
string
router for a record closed on the router, venue for a record an auction sold in full, null for a write-off.string
Router the record lives on. Present on router records when the router could be read, like the five fields below.
boolean
Whether the router has closed its own record. A written-off record usually reads
false, because the write-off never touches the router.string
Collateral still on the router for this record.
string
Cash the router collected for this record, in borrow asset units.
boolean
true when the router closed the record with collateral still on it. That collateral can no longer be withdrawn.boolean
true when the collateral is stranded and the record collected nothing, which is when Reopen Liquidation accepts it.string
The loan’s whole debt when it was seized, in borrow asset units. Present when the market’s record could be read, like the five fields below.
string
The principal the record claimed, in borrow asset units.
string
Debt the seizure wrote off at once because the collateral could not cover it, or
null.string
What the insurance fund paid toward that write-off, or
null.string
Principal neither the sale nor the insurance fund covered, which the pool bore.
null when there is none, or while the market’s record is still open.string
What the insurance fund paid when the market’s record settled, or
null.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.curl "https://api.trusset.org/lending-external-securities-v2/api/liquidations/{marketId}/settled-liquidations?limit=20" \
-H "X-API-Key: trusset_your_key_here"
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);
{
"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,
"realization": "ROUTER",
"buyer": 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,
"totalDebtAtSeizure": "16240.0",
"principalOwed": "8000.0",
"writtenOffAtSeizure": null,
"seizureReserveCovered": null,
"shortfall": null,
"reserveCovered": null,
"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",
"realization": "ROUTER",
"buyer": null,
"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,
"totalDebtAtSeizure": "42318.4",
"principalOwed": "20900.0",
"writtenOffAtSeizure": null,
"seizureReserveCovered": null,
"shortfall": null,
"reserveCovered": null,
"settledOn": "router"
}
],
"totalCount": 2,
"limit": 50,
"offset": 0,
"hasMore": false
}
}
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 |
500 INTERNAL_ERROR. A failed chain read never fails the request: the fields that depend on it are left out.⌘I
curl "https://api.trusset.org/lending-external-securities-v2/api/liquidations/{marketId}/settled-liquidations?limit=20" \
-H "X-API-Key: trusset_your_key_here"
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);
{
"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,
"realization": "ROUTER",
"buyer": 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,
"totalDebtAtSeizure": "16240.0",
"principalOwed": "8000.0",
"writtenOffAtSeizure": null,
"seizureReserveCovered": null,
"shortfall": null,
"reserveCovered": null,
"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",
"realization": "ROUTER",
"buyer": null,
"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,
"totalDebtAtSeizure": "42318.4",
"principalOwed": "20900.0",
"writtenOffAtSeizure": null,
"seizureReserveCovered": null,
"shortfall": null,
"reserveCovered": null,
"settledOn": "router"
}
],
"totalCount": 2,
"limit": 50,
"offset": 0,
"hasMore": false
}
}