Order Books
List Importable Order Books
Discover external securities books other instances have published
GET
/
orderbooks
/
external-securities
/
api
/
order-books
/
importable
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/importable" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/order-books/importable',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": [
{
"id": "clx_ob_extsec_088",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"tokenType": "EXTERNAL_SECURITY",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"minOrderSize": "1000000",
"maxOrderSize": null,
"tickSize": "10000",
"makerFeeBps": 0,
"takerFeeBps": 10,
"createdAt": "2025-05-20T14:12:00.000Z"
}
]
}
Returns the external securities 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.
Importing is how you quote a security another venue already lists. Combined with shared liquidity on both sides, it is how two venues end up matching against one pool of depth on the same instrument.
Response Fields
array
Show child attributes
Show child attributes
string
Order book ID. Pass it to Import Order Book.
string
Security token.
string
Settlement asset.
string
Display name.
string
Display symbol.
string
EXTERNAL_SECURITY.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 summary does not include the instrument identifier or the recorded decimals. Import the book to read its full record, then use Get Security Status for the on-chain detail.
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/importable" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/order-books/importable',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": [
{
"id": "clx_ob_extsec_088",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"tokenType": "EXTERNAL_SECURITY",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"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/external-securities/api/order-books/importable" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/order-books/importable',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
{
"success": true,
"data": [
{
"id": "clx_ob_extsec_088",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"tokenType": "EXTERNAL_SECURITY",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"minOrderSize": "1000000",
"maxOrderSize": null,
"tickSize": "10000",
"makerFeeBps": 0,
"takerFeeBps": 10,
"createdAt": "2025-05-20T14:12:00.000Z"
}
]
}