Trusset Protocol - Infrastructure for Asset Tokenization

GET

orderbooks

commodities

api

order-books

{orderBookId}

price-reference

curl "https://api.trusset.org/orderbooks/commodities/api/order-books/clx_ob_comm_001/price-reference" \
  -H "X-API-Key: trusset_your_key_here"

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

{
  "success": true,
  "data": {
    "enabled": true,
    "mode": "EXTERNAL_FEED",
    "enforcement": "1MIN",
    "spreadBps": 100,
    "haltOnStale": true,
    "staleTolerance": 300,
    "currentPrice": "2412.55",
    "lowerBound": "2388.4245",
    "upperBound": "2436.6755",
    "lastUpdated": "2025-06-15T11:59:30.000Z"
  }
}

Returns the book’s reference configuration together with the live price and the band derived from it. The price is resolved the same way an incoming order would resolve it: from cache if the enforcement interval has not elapsed, otherwise from the configured source. A book with the reference disabled returns its configuration with currentPrice, lowerBound and upperBound all null. So does a book whose feed could not be reached. This read is deliberately forgiving, so a monitoring call does not fail because a feed blinked. Submit Order takes the stricter view and can refuse with PRICE_REF_STALE.

Path Parameters

string

required

Order book ID.

Response Fields

object

Show child attributes

boolean

Whether the band is enforced on incoming orders.

string

MANUAL, STOCK_FEED or EXTERNAL_FEED.

string

Refresh interval, from EVERY_TRADE to 1DAY.

integer

Band half-width in basis points, or null if no band is enforced.

boolean

Whether a stale reference stops trading.

integer

Staleness window in seconds, or null for the derived default.

string

Live reference price as a plain decimal, or null.

string

Lowest accepted price as a plain decimal, or null.

string

Highest accepted price as a plain decimal, or null.

string

When the stored reference was last written, or null.

Bounds are decimals in the quote currency. An order’s price is an order book unit integer, so divide it by 1000000 before comparing it against lowerBound and upperBound.

curl "https://api.trusset.org/orderbooks/commodities/api/order-books/clx_ob_comm_001/price-reference" \
  -H "X-API-Key: trusset_your_key_here"

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

{
  "success": true,
  "data": {
    "enabled": true,
    "mode": "EXTERNAL_FEED",
    "enforcement": "1MIN",
    "spreadBps": 100,
    "haltOnStale": true,
    "staleTolerance": 300,
    "currentPrice": "2412.55",
    "lowerBound": "2388.4245",
    "upperBound": "2436.6755",
    "lastUpdated": "2025-06-15T11:59:30.000Z"
  }
}

Error Codes

Code	HTTP	Cause
`INVALID_PARAM`	`400`	`orderBookId` is missing or longer than 100 characters
`ORDER_BOOK_NOT_FOUND`	`404`	No such commodity book on this instance, and not imported
`SERVICE_NOT_ENABLED`	`403`	The Trading service is not enabled on this instance

curl "https://api.trusset.org/orderbooks/commodities/api/order-books/clx_ob_comm_001/price-reference" \
  -H "X-API-Key: trusset_your_key_here"

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

{
  "success": true,
  "data": {
    "enabled": true,
    "mode": "EXTERNAL_FEED",
    "enforcement": "1MIN",
    "spreadBps": 100,
    "haltOnStale": true,
    "staleTolerance": 300,
    "currentPrice": "2412.55",
    "lowerBound": "2388.4245",
    "upperBound": "2436.6755",
    "lastUpdated": "2025-06-15T11:59:30.000Z"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Stock Trading

External Securities Trading

Commodity Trading

Stock Lending

External Securities Lending

Vaults

Get Price Reference

Path Parameters

Response Fields

Error Codes

​Path Parameters

​Response Fields

​Error Codes

Path Parameters

Response Fields

Error Codes