> ## 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.

# List Order Books

> List the external securities books your instance owns or has imported

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](/endpoints/external-securities-trading/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

<ParamField query="status" type="string">
  Restrict to one status: `ACTIVE`, `PAUSED` or `CLOSED`. Applies to owned and imported books alike.
</ParamField>

## Response Fields

`data` is an array of order book records, each with the same fields as [Get Order Book](/endpoints/external-securities-trading/get-order-book), plus:

<ResponseField name="_imported" type="boolean">Present and `true` only on imported books.</ResponseField>

<ResponseField name="_importId" type="string">Present only on imported books.</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/orderbooks/external-securities/api/order-books?status=ACTIVE" \
    -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?status=ACTIVE',
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  );
  const { data } = await res.json();
  const settleable = data.filter((b: any) => !b._imported);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

| Code                  | HTTP  | Cause                                               |
| --------------------- | ----- | --------------------------------------------------- |
| `SERVICE_NOT_ENABLED` | `403` | The Trading service is not enabled on this instance |