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

# Set Price Reference

> Set the manual reference price for an order book

Sets the manual reference price for an order book. This applies when `priceRefMode` is `MANUAL`: the submitted price becomes the new reference around which the spread band is computed. Each update is recorded in the price reference history.

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

## Request Body

<ParamField body="price" type="string" required>
  The reference price as a decimal string. 1-64 characters, matching `^\d+\.?\d*$` (for example `"100.25"`).
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "price": "100.25"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "orderBookId": "ob_abc123",
      "price": "100.25",
      "mode": "MANUAL",
      "updatedAt": "2025-01-15T10:30:00.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  |
| `PRICE_REF_DISABLED`   | 400    | Price reference is not enabled for this order book |
| `INVALID_PRICE`        | 400    | Invalid price value                                |
| `VALIDATION_ERROR`     | 400    | Request body failed schema validation              |