> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Order Book
> Retrieve the full configuration of one external securities book
Returns the stored record for a single book: its pair, status, recorded decimals, settlement operator, sizing rules, fees, and price reference configuration.
Books you own and books you have imported both resolve. A book that is neither, or whose token type is not an external security, returns `ORDER_BOOK_NOT_FOUND` rather than disclosing that it exists.
This read is stored state only. For live on-chain registration, authorization and balances, use [Get Security Status](/endpoints/external-securities-trading/get-security-status).
## Path Parameters
Order book ID.
## Response Fields
Order book ID.
Owning instance. Differs from yours on an imported book.
Security token.
Settlement asset.
Display name.
Display symbol.
`ACTIVE`, `PAUSED` or `CLOSED`.
`EXTERNAL_SECURITY`.
`ON_CHAIN`.
Custody contract the book settles through.
Wallet authorized to sign settlements for this book.
Instrument identifier recorded on chain. Shared liquidity keys on this.
Security token decimals, read at creation.
Settlement asset decimals, read at creation.
Minimum quantity in order book units.
Maximum quantity, or `null`.
Price increment in order book units.
Maker fee in basis points.
Taker fee in basis points.
Market maker fee override, or `null`.
Whether other instances may import the book.
Whether the book pools depth with its peers.
`CONTINUOUS`.
Commodity fungibility class. `null` on this venue.
`null` on this venue.
Whether the band is enforced.
`MANUAL`, `STOCK_FEED` or `EXTERNAL_FEED`.
External feed endpoint, or `null`.
Feed headers as a JSON string, or `null`.
JSON path, or the ticker in `STOCK_FEED` mode.
Refresh interval.
Band half-width in basis points, or `null`.
Last recorded reference price, as a plain decimal.
ISO 8601 timestamp, or `null`.
Whether a stale reference stops trading.
Staleness window in seconds, or `null`.
Move that pauses the book, or `null`.
ISO 8601 timestamp.
ISO 8601 timestamp.
```bash cURL theme={null}
curl "https://api.trusset.org/orderbooks/external-securities/api/order-books/clx_ob_extsec_001" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/order-books/${orderBookId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.symbol, data.underlyingIdentifier, data.baseDecimals, data.quoteDecimals);
```
```json Response theme={null}
{
"success": true,
"data": {
"id": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
"quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
"name": "Helvetia Growth Fund",
"symbol": "HELG",
"status": "ACTIVE",
"tokenType": "EXTERNAL_SECURITY",
"settlementMode": "ON_CHAIN",
"custodyContract": "0x489aee4ae9546081d55848f157e03192e826988c",
"settlementOperator": "0x5ad87a0621175206b72d10e4b8577b192e7f40ab",
"underlyingIdentifier": "CH0012032048",
"baseDecimals": 18,
"quoteDecimals": 6,
"minOrderSize": "1000000",
"maxOrderSize": null,
"tickSize": "10000",
"makerFeeBps": 0,
"takerFeeBps": 10,
"mmMakerRebateBps": null,
"allowImport": true,
"allowSharedLiquidity": true,
"tradingMode": "CONTINUOUS",
"cfid": null,
"stockTokenId": null,
"priceRefEnabled": true,
"priceRefMode": "MANUAL",
"priceRefFeedUrl": null,
"priceRefFeedHeaders": null,
"priceRefFeedPath": null,
"priceRefEnforcement": "1HOUR",
"priceRefSpreadBps": 500,
"priceRefLastPrice": "104.20",
"priceRefLastUpdated": "2025-06-15T11:00:00.000Z",
"priceRefHaltOnStale": false,
"priceRefStaleTolerance": null,
"priceRefCircuitBreakerBps": 2000,
"createdAt": "2025-06-01T09:00:00.000Z",
"updatedAt": "2025-06-15T11:00:00.000Z"
}
}
```
## Error Codes
| Code | HTTP | Cause |
| ---------------------- | ----- | ------------------------------------------------------------------- |
| `ORDER_BOOK_NOT_FOUND` | `404` | No such external securities book on this instance, and not imported |
| `SERVICE_NOT_ENABLED` | `403` | The Trading service is not enabled on this instance |