Trusset Protocol - Infrastructure for Asset Tokenization

POST

orderbooks

stocks

api

order-books

{orderBookId}

price-reference

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/order-books/clx_ob_stock_002/price-reference" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "price": "182.35" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/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();

{
  "success": true,
  "data": {
    "price": "182.35",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "PRICE_REF_DISABLED",
    "message": "Price reference is not enabled for this order book"
  }
}

Records a reference price on a book and makes it effective immediately. Use this when the book is in MANUAL mode; in STOCK_FEED or EXTERNAL_FEED mode the reference is fetched rather than pushed, and a value posted here is overwritten by the next fetch. The book must belong to your instance and must have priceRefEnabled set, otherwise the request is refused with PRICE_REF_DISABLED. Publishing a price has three effects beyond storing it. It resets the staleness clock. It writes an entry into the price reference log. And if the move is large enough it can pause the book or cancel resting orders.

Path Parameters

string

required

Order book ID. Must be a book your instance owns.

Body Parameters

string

required

Reference price as a plain positive decimal, such as "182.35". This is the instrument’s price in the quote currency, not an order book unit value. Up to 64 characters, digits with at most one decimal point.

Side effects

Circuit breaker. If priceRefCircuitBreakerBps is set and the new price differs from the previous one by more than that threshold, the book is moved to PAUSED and a CIRCUIT_BREAKER_TRIGGERED entry is written to the log. The request still succeeds; the pause is the response to it. Reopen the book with Update Order Book once you are satisfied the move is real. Band sweep. If the circuit breaker did not trip and priceRefSpreadBps is set, resting limit orders that now fall outside the band are cancelled with PRICE_BAND_VIOLATION and their reservations released. This runs in the background, so the cancellations may land a moment after the response. Neither runs on the first price a book ever receives, since there is nothing to compare against.

Response Fields

object

Show child attributes

string

The stored price, normalised.

string

ISO 8601 timestamp.

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/order-books/clx_ob_stock_002/price-reference" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "price": "182.35" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/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();

{
  "success": true,
  "data": {
    "price": "182.35",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "PRICE_REF_DISABLED",
    "message": "Price reference is not enabled for this order book"
  }
}

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. Imported books cannot be repriced
`SERVICE_NOT_ENABLED`	`403`	The Trading service is not enabled on this instance

curl -X POST "https://api.trusset.org/orderbooks/stocks/api/order-books/clx_ob_stock_002/price-reference" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "price": "182.35" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/stocks/api/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();

{
  "success": true,
  "data": {
    "price": "182.35",
    "updatedAt": "2025-06-15T12:00:00.000Z"
  }
}

{
  "success": false,
  "data": null,
  "error": {
    "code": "PRICE_REF_DISABLED",
    "message": "Price reference is not enabled for this order book"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Set Price Reference

Path Parameters

Body Parameters

Side effects

Response Fields

Error Codes

​Path Parameters

​Body Parameters

​Side effects

​Response Fields

​Error Codes

Path Parameters

Body Parameters

Side effects

Response Fields

Error Codes