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

> Retrieve historical reference price points for an order book

Returns a paginated list of historical reference price points for an order book, ordered by most recent first. Each point records the reference price and its source at the time it was captured.

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

## Query Parameters

<ParamField query="limit" type="integer">
  Number of points to return. Default `50`, maximum `100`.
</ParamField>

<ParamField query="offset" type="integer">
  Offset for pagination. Default `0`.
</ParamField>

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

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "price": "100000000000000000000",
        "source": "EXTERNAL_FEED",
        "timestamp": "2025-01-15T10:29:30.000Z"
      },
      {
        "price": "99800000000000000000",
        "source": "EXTERNAL_FEED",
        "timestamp": "2025-01-15T10:28: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 |