Order Books
List Order Books
List the external securities books your instance owns or has imported
GET
/
orderbooks
/
external-securities
/
api
/
order-books
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books?status=ACTIVE" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/order-books?status=ACTIVE',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const settleable = data.filter((b: any) => !b._imported);
{
"success": true,
"data": [
{
"id": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"settlementMode": "ON_CHAIN",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"settlementOperator": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"underlyingIdentifier": "CH0012032048",
"baseDecimals": 18,
"quoteDecimals": 6,
"allowImport": true,
"allowSharedLiquidity": true,
"tradingMode": "CONTINUOUS",
"createdAt": "2025-06-01T09:00:00.000Z"
},
{
"id": "clx_ob_extsec_088",
"instanceId": "inst_partner_9",
"name": "Nyala Fund I",
"symbol": "NYF1",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"underlyingIdentifier": "DE000A0F5UF5",
"_imported": true,
"_importId": "clx_import_022"
}
]
}
Returns every external securities book on your instance, newest first, followed by every book you have imported from another instance.
Imported books carry two extra fields,
_imported and _importId, which owned books do not have. _importId is what Remove Import takes.
The distinction matters more here than on the other venues: settlement authority stays with the owner, so a fill on an imported book gives you a settlement reference rather than a transaction you can send.
Query Parameters
string
Restrict to one status:
ACTIVE, PAUSED or CLOSED. Applies to owned and imported books alike.Response Fields
data is an array of order book records, each with the same fields as Get Order Book, plus:
boolean
Present and
true only on imported books.string
Present only on imported books.
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books?status=ACTIVE" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/order-books?status=ACTIVE',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const settleable = data.filter((b: any) => !b._imported);
{
"success": true,
"data": [
{
"id": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"settlementMode": "ON_CHAIN",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"settlementOperator": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"underlyingIdentifier": "CH0012032048",
"baseDecimals": 18,
"quoteDecimals": 6,
"allowImport": true,
"allowSharedLiquidity": true,
"tradingMode": "CONTINUOUS",
"createdAt": "2025-06-01T09:00:00.000Z"
},
{
"id": "clx_ob_extsec_088",
"instanceId": "inst_partner_9",
"name": "Nyala Fund I",
"symbol": "NYF1",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"underlyingIdentifier": "DE000A0F5UF5",
"_imported": true,
"_importId": "clx_import_022"
}
]
}
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?status=ACTIVE" \
-H "X-API-Key: trusset_your_key_here"
const res = await fetch(
'https://api.trusset.org/orderbooks/external-securities/api/order-books?status=ACTIVE',
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const settleable = data.filter((b: any) => !b._imported);
{
"success": true,
"data": [
{
"id": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"settlementMode": "ON_CHAIN",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"settlementOperator": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"underlyingIdentifier": "CH0012032048",
"baseDecimals": 18,
"quoteDecimals": 6,
"allowImport": true,
"allowSharedLiquidity": true,
"tradingMode": "CONTINUOUS",
"createdAt": "2025-06-01T09:00:00.000Z"
},
{
"id": "clx_ob_extsec_088",
"instanceId": "inst_partner_9",
"name": "Nyala Fund I",
"symbol": "NYF1",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"underlyingIdentifier": "DE000A0F5UF5",
"_imported": true,
"_importId": "clx_import_022"
}
]
}