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

> Publish a manual reference price from the off-chain surface

Records a reference price on a book you own. Identical in behaviour to [Set Price Reference](/endpoints/stock-trading/set-price-reference), including the circuit breaker and the band sweep over resting orders, and served here so a customer-facing integration does not need the Trading service entitlement.

The book must have `priceRefEnabled` set. The route does not assert the settlement mode, so it also works on an on-chain book you own.

## Path Parameters

<ParamField path="orderBookId" type="string" required>Order book ID. Must be a book your instance owns.</ParamField>

## Body Parameters

<ParamField body="price" type="string" required>
  Reference price as a plain positive decimal, such as `"182.35"`. Not an order book unit value.
</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="price" type="string">The stored price, normalised.</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/clx_ob_stock_001/price-reference" \
    -H "X-API-Key: trusset_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{ "price": "182.35" }'
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    `https://api.trusset.org/orderbooks/stocks/api/offchain/order-books/${orderBookId}/price-reference`,
    {
      method: 'POST',
      headers: {
        'X-API-Key': 'trusset_your_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ price: '182.35' })
    }
  );
  const { data } = await res.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": { "price": "182.35", "updatedAt": "2025-06-15T12:00:00.000Z" }
  }
  ```
</ResponseExample>

## Error Codes

| Code                   | HTTP  | Cause                                                            |
| ---------------------- | ----- | ---------------------------------------------------------------- |
| `VALIDATION_ERROR`     | `400` | `price` is missing or not a positive decimal string              |
| `INVALID_PARAM`        | `400` | `orderBookId` is missing or longer than 100 characters           |
| `INVALID_PRICE`        | `400` | `price` parses to zero, a negative number, or a non-finite value |
| `PRICE_REF_DISABLED`   | `400` | The book does not have `priceRefEnabled` set                     |
| `ORDER_BOOK_NOT_FOUND` | `404` | The book does not exist on your instance                         |