> ## 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 a specific auction by ID

Returns a single auction by ID, including its final clearing price and matched volume once the auction has settled. Use this to retrieve historical auction results or to inspect a specific batch.

## Authentication

Requires an instance API key with the `trading` service enabled.

## Path Parameters

<ParamField path="orderBookId" type="string" required>
  The order book identifier. Max 100 characters.
</ParamField>

<ParamField path="auctionId" type="string" required>
  The auction identifier. Max 100 characters.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://api.trusset.org/orderbooks/stocks/api/order-books/ob_abc123/auctions/auc_001" \
    -H "x-api-key: trusset_{instanceRef}_{secret}"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "auctionId": "auc_001",
      "orderBookId": "ob_abc123",
      "status": "SETTLED",
      "startTime": "2025-01-15T10:30:00.000Z",
      "endTime": "2025-01-15T10:35:00.000Z",
      "clearingPrice": "100000000000000000000",
      "matchedVolume": "12000000000000000000",
      "tradeCount": 7,
      "settledAt": "2025-01-15T10:35:02.000Z"
    },
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-01-15T10:36:00.000Z",
      "instanceId": "inst_abc"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code                   | Status | Description                                       |
| ---------------------- | ------ | ------------------------------------------------- |
| `ORDER_BOOK_NOT_FOUND` | 404    | No order book found with this ID in your instance |
| `NOT_FOUND`            | 404    | No auction found with this ID for this order book |