> ## 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 Loan Auction

> Find the auction currently running against a loan

Looks up the Dutch auction attached to a specific loan. Use it to show a borrower that their collateral is being auctioned, or to check whether a loan already has an auction before liquidating again.

## Path Parameters

<ParamField path="marketId" type="string" required>Market ID.</ParamField>
<ParamField path="loanId" type="integer" required>On-chain loan ID. Must be a positive integer.</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="loanId" type="string">The loan ID queried, echoed back.</ResponseField>

    <ResponseField name="auction" type="object">
      The auction, with the same fields as [Get Auction](/endpoints/external-securities-lending/get-auction), or `null` when the loan has no auction running.
    </ResponseField>
  </Expandable>
</ResponseField>

<Warning>
  This is a live lookup, not a history. The market clears the loan-to-auction link once an auction fully settles or expires, so a loan that was auctioned yesterday returns `auction: null` today. To inspect a finished auction, query it directly by ID through [Get Auction](/endpoints/external-securities-lending/get-auction).
</Warning>

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

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

  ```json Response - No Auction theme={null}
  {
    "success": true,
    "data": {
      "loanId": "7",
      "auction": null
    }
  }
  ```
</ResponseExample>