Order Books
List Importable Order Books
Discover stock order books other instances have published
GET
/
orderbooks
/
stocks
/
api
/
order-books
/
importable
curl "https://api.trusset.org/orderbooks/stocks/api/order-books/importable" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/stocks/api/order-books/importable',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const book of data) console.log(book.symbol, book.id, book.takerFeeBps);
{
"success": true,
"data": [
{
"id": "clx_ob_stock_044",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth",
"symbol": "HELG",
"tokenType": "STOCK_TOKEN",
"custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
"minOrderSize": "1000000",
"maxOrderSize": null,
"tickSize": "10000",
"makerFeeBps": 0,
"takerFeeBps": 10,
"createdAt": "2025-05-20T14:12:00.000Z"
}
]
}
Returns the stock order books that other instances have opened for import and that you have not imported yet. A book qualifies when it is
ACTIVE, settles on-chain, has allowImport set, and belongs to another instance. Newest first, capped at 100 entries.
Only a summary is returned. Import the book to read its full record, its depth and its trades.
Response Fields
array
Show child attributes
Show child attributes
string
Order book ID. Pass it to Import Order Book.
string
Base token.
string
Quote token.
string
Display name.
string
Display symbol.
string
STOCK_TOKEN.string
Custody contract the book settles through.
string
Minimum quantity in order book units.
string
Maximum quantity, or
null.string
Price increment in order book units.
integer
Maker fee charged by the owning book.
integer
Taker fee charged by the owning book.
string
ISO 8601 timestamp.
The list is not filtered by network. Import Order Book refuses a book whose owner runs on a different network with
NETWORK_MISMATCH.curl "https://api.trusset.org/orderbooks/stocks/api/order-books/importable" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/stocks/api/order-books/importable',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const book of data) console.log(book.symbol, book.id, book.takerFeeBps);
{
"success": true,
"data": [
{
"id": "clx_ob_stock_044",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth",
"symbol": "HELG",
"tokenType": "STOCK_TOKEN",
"custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
"minOrderSize": "1000000",
"maxOrderSize": null,
"tickSize": "10000",
"makerFeeBps": 0,
"takerFeeBps": 10,
"createdAt": "2025-05-20T14:12:00.000Z"
}
]
}
Error Codes
| Code | HTTP | Cause |
|---|---|---|
SERVICE_NOT_ENABLED | 403 | The Trading service is not enabled on this instance |
⌘I
curl "https://api.trusset.org/orderbooks/stocks/api/order-books/importable" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/stocks/api/order-books/importable',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
for (const book of data) console.log(book.symbol, book.id, book.takerFeeBps);
{
"success": true,
"data": [
{
"id": "clx_ob_stock_044",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth",
"symbol": "HELG",
"tokenType": "STOCK_TOKEN",
"custodyContract": "0x98c33b10823172e62a31d6048773df1054c4f821",
"minOrderSize": "1000000",
"maxOrderSize": null,
"tickSize": "10000",
"makerFeeBps": 0,
"takerFeeBps": 10,
"createdAt": "2025-05-20T14:12:00.000Z"
}
]
}