> For the complete documentation index, see [llms.txt](https://faq.finerymarkets.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faq.finerymarkets.com/api-reference/rest-api/trading/orders-and-order-book/book.md).

# book

**POST api/book**

{% tabs %}
{% tab title="Payload" %}

```json
{
    "instrument": "BTC-USD",
    "tradable": true
}
```

{% endtab %}

{% tab title="Payload for Masters" %}

```json
{
    "instrument": "BTC-USD",
    "tradable": true,
    "clientId": 123
}
```

{% endtab %}

{% tab title="200 OK" %}

```json
[
    [       // Bids
        [
            1100000000000,    // Price
            11000000          // Size
        ],
        [
            1099900000000,
            100000000
        ]
    ],
    [       // Asks
        [
            1100100000000,    // Price
            80000000          // Size
        ],
        [
            1100200000000,
            200000000
        ]
    ]
]
```

{% endtab %}

{% tab title="400 Bad request" %}

```json
{
    "error": 2
}
```

{% endtab %}
{% endtabs %}

**Request parameters**

| Field name | Type           | Description                                                                                                     |
| ---------- | -------------- | --------------------------------------------------------------------------------------------------------------- |
| instrument | string         | Instrument name                                                                                                 |
| tradable   | boolean        | <p>Default: false</p><p>Whether to return Tradable order book. By default method returns Global order book.</p> |
| clientId   | unsigned int32 | Specify the sub-account ID (Only for Master Accounts)                                                           |

**Response description**

| Filed name | Type            | Description                             |
| ---------- | --------------- | --------------------------------------- |
|            | Array\[2]       | Book                                    |
| 0          | Array of Levels | Bid Levels (sorted by descending price) |
| 1          | Array of Levels | Ask Levels (sorted by ascending price)  |
| **Level**  | Array\[2]       |                                         |
| 0          | Efx::Price      | Level price                             |
| 1          | Efx::Size       | Level total size                        |