> ## 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 Price Reference

> Retrieve the current price reference state and band for an order book

Returns the current price reference configuration and live state for an order book. When the reference is enabled and available, the response includes the current reference price and the computed lower and upper price bounds derived from `spreadBps`.

If the reference is disabled, or cannot be retrieved at request time, `currentPrice`, `lowerBound`, and `upperBound` are returned as `null` while the configuration fields still reflect the book settings.

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

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

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "enabled": true,
      "mode": "EXTERNAL_FEED",
      "enforcement": "1MIN",
      "spreadBps": 200,
      "haltOnStale": true,
      "staleTolerance": 300,
      "currentPrice": "100000000000000000000",
      "lowerBound": "98000000000000000000",
      "upperBound": "102000000000000000000",
      "lastUpdated": "2025-01-15T10:29:30.000Z"
    },
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-01-15T10:30: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 |