Trusset Protocol - Infrastructure for Asset Tokenization

POST

orderbooks

commodities

api

order-books

{orderBookId}

price-reference

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

const res = await fetch(
  `https://api.trusset.org/orderbooks/commodities/api/order-books/${orderBookId}/price-reference`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: '2412.55' })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": { "price": "2412.55", "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 the feed modes the reference is fetched, and a value posted here is overwritten by the next fetch. Commodities usually have a live external benchmark, so a feed is the natural configuration and manual pricing is the fallback when the feed is down or the instrument has no public quote. The book must belong to your instance and have priceRefEnabled set, otherwise the request is refused with PRICE_REF_DISABLED.

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 "2412.55". The commodity’s price in the quote currency per unit of the token, not an order book unit value. Up to 64 characters.

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 now outside the band are cancelled with PRICE_BAND_VIOLATION and their reservations released. This runs in the background, so cancellations may land a moment after the response. Neither runs on the first price a book ever receives.

Response Fields

object

Show child attributes

string

The stored price, normalised.

string

ISO 8601 timestamp.

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

const res = await fetch(
  `https://api.trusset.org/orderbooks/commodities/api/order-books/${orderBookId}/price-reference`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: '2412.55' })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": { "price": "2412.55", "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/commodities/api/order-books/clx_ob_comm_001/price-reference" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "price": "2412.55" }'

const res = await fetch(
  `https://api.trusset.org/orderbooks/commodities/api/order-books/${orderBookId}/price-reference`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ price: '2412.55' })
  }
);
const { data } = await res.json();

{
  "success": true,
  "data": { "price": "2412.55", "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

Stock Tokenization

Stock Trading

External Securities Trading

Commodity Trading

Stock Lending

External Securities Lending

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