Trusset Protocol - Infrastructure for Asset Tokenization

GET

orderbooks

stocks

api

order-books

{orderBookId}

price-reference

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

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

const inBand = (obPrice: string) => {
  if (!data.lowerBound) return true;
  const human = Number(obPrice) / 1e6;
  return human >= Number(data.lowerBound) && human <= Number(data.upperBound);
};

{
  "success": true,
  "data": {
    "enabled": true,
    "mode": "STOCK_FEED",
    "enforcement": "5MIN",
    "spreadBps": 200,
    "haltOnStale": true,
    "staleTolerance": null,
    "currentPrice": "182.35",
    "lowerBound": "178.703",
    "upperBound": "185.997",
    "lastUpdated": "2025-06-15T11:58:00.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 source could not be reached. The read is deliberately forgiving here, and a fetch failure is reported as an absent price rather than an error, because a monitoring call should not fail just 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 instrument’s 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/stocks/api/order-books/clx_ob_stock_002/price-reference" \
  -H "X-API-Key: trusset_your_key_here"

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

const inBand = (obPrice: string) => {
  if (!data.lowerBound) return true;
  const human = Number(obPrice) / 1e6;
  return human >= Number(data.lowerBound) && human <= Number(data.upperBound);
};

{
  "success": true,
  "data": {
    "enabled": true,
    "mode": "STOCK_FEED",
    "enforcement": "5MIN",
    "spreadBps": 200,
    "haltOnStale": true,
    "staleTolerance": null,
    "currentPrice": "182.35",
    "lowerBound": "178.703",
    "upperBound": "185.997",
    "lastUpdated": "2025-06-15T11:58:00.000Z"
  }
}

Error Codes

Code	HTTP	Cause
`INVALID_PARAM`	`400`	`orderBookId` is missing or longer than 100 characters
`ORDER_BOOK_NOT_FOUND`	`404`	No such stock 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/stocks/api/order-books/clx_ob_stock_002/price-reference" \
  -H "X-API-Key: trusset_your_key_here"

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

const inBand = (obPrice: string) => {
  if (!data.lowerBound) return true;
  const human = Number(obPrice) / 1e6;
  return human >= Number(data.lowerBound) && human <= Number(data.upperBound);
};

{
  "success": true,
  "data": {
    "enabled": true,
    "mode": "STOCK_FEED",
    "enforcement": "5MIN",
    "spreadBps": 200,
    "haltOnStale": true,
    "staleTolerance": null,
    "currentPrice": "182.35",
    "lowerBound": "178.703",
    "upperBound": "185.997",
    "lastUpdated": "2025-06-15T11:58:00.000Z"
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Price Reference

Path Parameters

Response Fields

Error Codes

​Path Parameters

​Response Fields

​Error Codes

Path Parameters

Response Fields

Error Codes