Market Data
Get Daily Stats
Daily OHLC and volume history for every book on one security
GET
/
orderbooks
/
external-securities
/
api
/
order-books
/
by-token
/
{tokenAddress}
/
daily-stats
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/by-token/0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912/daily-stats?range=3M" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/order-books/by-token/${tokenAddress}/daily-stats?range=3M`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"hasOrderbook": true,
"orderbooks": [
{
"id": "clx_ob_extsec_001",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"settlementMode": "ON_CHAIN",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a"
}
],
"stats": [
{
"date": "2025-06-14",
"orderCount": 4,
"tradeCount": 2,
"volumeBase": 20,
"volumeQuote": 2084,
"priceHigh": 104.8,
"priceLow": 103.9,
"priceOpen": 103.9,
"priceClose": 104.2
}
],
"range": "3M",
"truncated": false,
"totals": {
"orderCount": 122,
"tradeCount": 61,
"volumeBase": 884,
"volumeQuote": 92086.4
}
}
}
Returns a day-by-day series for a security token rather than a single book. Every non-closed external securities book your instance holds on that token contributes, and any pooled peers of those books contribute too, so the series describes the instrument as your venue sees it.
The response always carries one entry per calendar day in the range, in UTC, including days with no activity, so the series is directly plottable.
Path Parameters
string
required
Security token contract. Matched case-insensitively.
Query Parameters
string
default:"1M"
Window length:
1W, 1M, 3M, 6M or 1Y. Anything else returns INVALID_PARAM.Response Fields
object
Show child attributes
Show child attributes
boolean
False when your instance holds no non-closed external securities book on this token.
orderbooks and stats are then empty and totals are zero.array
The books that contributed, oldest first, each with
id, name, symbol, settlementMode, status, tokenType and quoteTokenAddress.array
One entry per day, oldest first.
Show child attributes
Show child attributes
string
UTC day,
YYYY-MM-DD.integer
Orders submitted that day.
integer
Trades executed that day.
number
Base volume as a decimal number.
number
Quote notional as a decimal number.
number
Highest trade price that day, or
null.number
Lowest trade price, or
null.number
First trade price, or
null.number
Last trade price, or
null.string
The range applied.
boolean
True when the underlying scan hit its 50,000-row ceiling, meaning the series understates a very busy instrument.
object
orderCount, tradeCount, volumeBase and volumeQuote across the range.Prices and volumes here are decimal numbers, not order book unit strings. Everywhere else on this surface amounts are integer strings; this endpoint is the display series and is scaled for charting.
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/by-token/0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912/daily-stats?range=3M" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/order-books/by-token/${tokenAddress}/daily-stats?range=3M`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"hasOrderbook": true,
"orderbooks": [
{
"id": "clx_ob_extsec_001",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"settlementMode": "ON_CHAIN",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a"
}
],
"stats": [
{
"date": "2025-06-14",
"orderCount": 4,
"tradeCount": 2,
"volumeBase": 20,
"volumeQuote": 2084,
"priceHigh": 104.8,
"priceLow": 103.9,
"priceOpen": 103.9,
"priceClose": 104.2
}
],
"range": "3M",
"truncated": false,
"totals": {
"orderCount": 122,
"tradeCount": 61,
"volumeBase": 884,
"volumeQuote": 92086.4
}
}
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
INVALID_PARAM | 400 | range is not one of the five accepted values |
VALIDATION_ERROR | 400 | tokenAddress is not a valid address |
INSTANCE_REQUIRED | 400 | The request carried no resolvable instance |
SERVICE_NOT_ENABLED | 403 | The Trading service is not enabled on this instance |
⌘I
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/by-token/0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912/daily-stats?range=3M" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/order-books/by-token/${tokenAddress}/daily-stats?range=3M`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": {
"hasOrderbook": true,
"orderbooks": [
{
"id": "clx_ob_extsec_001",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"settlementMode": "ON_CHAIN",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a"
}
],
"stats": [
{
"date": "2025-06-14",
"orderCount": 4,
"tradeCount": 2,
"volumeBase": 20,
"volumeQuote": 2084,
"priceHigh": 104.8,
"priceLow": 103.9,
"priceOpen": 103.9,
"priceClose": 104.2
}
],
"range": "3M",
"truncated": false,
"totals": {
"orderCount": 122,
"tradeCount": 61,
"volumeBase": 884,
"volumeQuote": 92086.4
}
}
}