Dutch Auctions
Get Auction
Retrieve one Dutch auction by ID
GET
/
lending-external-securities
/
api
/
liquidations
/
{marketId}
/
auctions
/
{auctionId}
curl "https://api.trusset.org/lending-external-securities/api/liquidations/{marketId}/auctions/3" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"auctionId": "3",
"loanId": "7",
"borrower": "0xabc...def",
"collateralRemaining": "120.000000000000000000",
"debtRemaining": "11359.200000",
"currentPrice": "112.180000",
"endTime": 1718449200,
"active": true
}
}
{
"success": false,
"error": {
"code": "AUCTION_NOT_FOUND",
"message": "Auction not found"
}
}
Returns a single auction with its live price. Unlike List Active Auctions, this returns closed and expired auctions too, with
active set to false.
Path Parameters
string
required
Market ID.
string
required
Auction ID.
Response Fields
object
Show child attributes
Show child attributes
string
Auction ID.
string
Loan being liquidated.
string
Borrower whose collateral is on sale.
string
Collateral still available, in collateral token units.
string
Debt still to be covered, in borrow asset units.
string
Live price per whole collateral unit, in borrow asset units.
integer
Unix seconds when the auction closes.
boolean
Whether the auction still accepts bids.
An auction ID that has never existed returns a zero-filled object rather than a
404: loanId of "0", borrower as the zero address, and active false. Check loanId !== "0" to confirm the auction is real. The AUCTION_NOT_FOUND error is only returned when the chain read itself fails.curl "https://api.trusset.org/lending-external-securities/api/liquidations/{marketId}/auctions/3" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"auctionId": "3",
"loanId": "7",
"borrower": "0xabc...def",
"collateralRemaining": "120.000000000000000000",
"debtRemaining": "11359.200000",
"currentPrice": "112.180000",
"endTime": 1718449200,
"active": true
}
}
{
"success": false,
"error": {
"code": "AUCTION_NOT_FOUND",
"message": "Auction not found"
}
}
⌘I
curl "https://api.trusset.org/lending-external-securities/api/liquidations/{marketId}/auctions/3" \
-H "X-API-Key: trusset_your_key_here"
{
"success": true,
"data": {
"auctionId": "3",
"loanId": "7",
"borrower": "0xabc...def",
"collateralRemaining": "120.000000000000000000",
"debtRemaining": "11359.200000",
"currentPrice": "112.180000",
"endTime": 1718449200,
"active": true
}
}
{
"success": false,
"error": {
"code": "AUCTION_NOT_FOUND",
"message": "Auction not found"
}
}