> ## 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.

# Get Auction

> Retrieve one Dutch auction by ID

Returns a single auction with its live price. Unlike [List Active Auctions](/endpoints/external-securities-lending/list-auctions), this returns closed and expired auctions too, with `active` set to `false`.

## Path Parameters

<ParamField path="marketId" type="string" required>Market ID.</ParamField>
<ParamField path="auctionId" type="string" required>Auction ID.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="auctionId" type="string">Auction ID.</ResponseField>
    <ResponseField name="loanId" type="string">Loan being liquidated.</ResponseField>
    <ResponseField name="borrower" type="string">Borrower whose collateral is on sale.</ResponseField>
    <ResponseField name="collateralRemaining" type="string">Collateral still available, in collateral token units.</ResponseField>
    <ResponseField name="debtRemaining" type="string">Debt still to be covered, in borrow asset units.</ResponseField>
    <ResponseField name="currentPrice" type="string">Live price per whole collateral unit, in borrow asset units.</ResponseField>
    <ResponseField name="endTime" type="integer">Unix seconds when the auction closes.</ResponseField>
    <ResponseField name="active" type="boolean">Whether the auction still accepts bids.</ResponseField>
  </Expandable>
</ResponseField>

<Warning>
  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.
</Warning>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/lending-external-securities/api/liquidations/{marketId}/auctions/3" \
    -H "X-API-Key: trusset_your_key_here"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "auctionId": "3",
      "loanId": "7",
      "borrower": "0xabc...def",
      "collateralRemaining": "120.000000000000000000",
      "debtRemaining": "11359.200000",
      "currentPrice": "112.180000",
      "endTime": 1718449200,
      "active": true
    }
  }
  ```

  ```json Error - Not Found theme={null}
  {
    "success": false,
    "error": {
      "code": "AUCTION_NOT_FOUND",
      "message": "Auction not found"
    }
  }
  ```
</ResponseExample>