> ## 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 Importable Order Books

> Discover commodity order books other instances have published

Returns the commodity 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, and it does not include the fungibility class. Import the book to read its full record and see whether it is in the same class as your own.

## Response Fields

<ResponseField name="data" type="array">
  <Expandable>
    <ResponseField name="id" type="string">Order book ID. Pass it to [Import Order Book](/endpoints/commodity-trading/import-order-book).</ResponseField>
    <ResponseField name="tokenAddress" type="string">Commodity token.</ResponseField>
    <ResponseField name="quoteTokenAddress" type="string">Settlement token (stablecoin).</ResponseField>
    <ResponseField name="name" type="string">Display name.</ResponseField>
    <ResponseField name="symbol" type="string">Display symbol.</ResponseField>
    <ResponseField name="tokenType" type="string">`LIGHT_TOKEN`.</ResponseField>
    <ResponseField name="custodyContract" type="string">Custody contract the book settles through.</ResponseField>
    <ResponseField name="minOrderSize" type="string">Minimum quantity in order book units.</ResponseField>
    <ResponseField name="maxOrderSize" type="string">Maximum quantity, or `null`.</ResponseField>
    <ResponseField name="tickSize" type="string">Price increment in order book units.</ResponseField>
    <ResponseField name="makerFeeBps" type="integer">Maker fee charged by the owning book.</ResponseField>
    <ResponseField name="takerFeeBps" type="integer">Taker fee charged by the owning book.</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/orderbooks/commodities/api/order-books/importable" \
    -H "X-API-Key: trusset_your_key_here"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    'https://api.trusset.org/orderbooks/commodities/api/order-books/importable',
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  );
  const { data } = await res.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "clx_ob_comm_055",
        "tokenAddress": "0x1a4f27c3d0e85b6971af2c5d3e8047b19c06fa2d",
        "quoteTokenAddress": "0x98ad0ca091552e23c564b41c74282e5343d03e8a",
        "name": "Zurich Vault Gold",
        "symbol": "ZVG",
        "tokenType": "LIGHT_TOKEN",
        "custodyContract": "0xf3dac9cf19da1c95a80de890e200bc86e0c6f2da",
        "minOrderSize": "1000000",
        "maxOrderSize": null,
        "tickSize": "10000",
        "makerFeeBps": 0,
        "takerFeeBps": 6,
        "createdAt": "2025-05-20T14:12:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>

## Error Codes

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