> ## 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 Shared Peers

> List instances that share liquidity on an order book

Returns the set of instances that share liquidity on this order book. Shared peers are the other instances that have imported the book (or whose book this instance has imported), forming a single combined liquidity pool across all of them.

## Authentication

Requires an instance API key with the `trading` service enabled.

## Path Parameters

<ParamField path="orderBookId" type="string" required>
  The order book identifier. Max 100 characters.
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET "https://api.trusset.org/orderbooks/stocks/api/order-books/ob_abc123/shared-peers" \
    -H "x-api-key: trusset_{instanceRef}_{secret}"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "orderBookId": "ob_abc123",
      "sharedLiquidityEnabled": true,
      "peers": [
        {
          "instanceId": "inst_def",
          "role": "IMPORTER",
          "status": "ACTIVE"
        },
        {
          "instanceId": "inst_ghi",
          "role": "IMPORTER",
          "status": "ACTIVE"
        }
      ]
    },
    "metadata": {
      "requestId": "550e8400-e29b-41d4-a716-446655440000",
      "timestamp": "2025-01-15T10:30:00.000Z",
      "instanceId": "inst_abc"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code                   | Status | Description                                       |
| ---------------------- | ------ | ------------------------------------------------- |
| `ORDER_BOOK_NOT_FOUND` | 404    | No order book found with this ID in your instance |