> For the complete documentation index, see [llms.txt](https://docs.bbx.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bbx.com/ru/publichnyi-api-bbx-dex/integraciya-coinmarketcap/derivativy/stakan-orderov-fyuchersov.md).

# Стакан ордеров фьючерсов

Возвращает текущую книгу ордеров для указанного рынка деривативов.

### Запрос

```http
GET /fapi/market/v1/public/cmc/orderbook
```

### Полный URL

```
https://dex.bbx.com/fapi/market/v1/public/cmc/orderbook
```

### Параметры запроса

| Параметр    | Расположение | Тип         | Обязательно | Описание                                                                                                                                                                 |
| ----------- | ------------ | ----------- | ----------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ticker_id` | запрос       | строка      |          Да | Идентификатор контракта, например `BTC-USDT`                                                                                                                             |
| `depth`     | запрос       | целое число |         Нет | Общее количество уровней с обеих сторон. Допустимые значения: `0`, `5`, `10`, `20`, `50`, `100`, `500`. `0` или, если параметр не указан, возвращает всю доступную книгу |
| `уровень`   | запрос       | целое число |         Нет | Уровень стакана: `1`, `2`, или `3`. По умолчанию: `2`                                                                                                                    |

### Поведение уровней

| Значение | Поведение                                                                                                    |
| -------- | ------------------------------------------------------------------------------------------------------------ |
| `1`      | Только лучшая цена покупки и лучшая цена продажи                                                             |
| `2`      | Книга ордеров, агрегированная по цене                                                                        |
| `3`      | Полный режим книги ордеров там, где поддерживается; в настоящее время может вести себя так же, как уровень 2 |

### Пример запроса

```
https://dex.bbx.com/fapi/market/v1/public/cmc/orderbook?ticker_id=BTC-USDT&depth=10&level=2
```

### cURL

```bash
curl -s \
  'https://dex.bbx.com/fapi/market/v1/public/cmc/orderbook?ticker_id=BTC-USDT&depth=10&level=2'
```

### Поля ответа

| Поле                | Тип         | Описание                                                                                  |
| ------------------- | ----------- | ----------------------------------------------------------------------------------------- |
| `ticker_id`         | строка      | Идентификатор контракта                                                                   |
| `timestamp`         | целое число | Время обновления стакана в Unix-миллисекундах                                             |
| `заявки на покупку` | массив      | Уровни бидов, форматируемые как `[цена, количество]`, отсортированные по убыванию цены    |
| `заявки на продажу` | массив      | Уровни асков, форматируемые как `[цена, количество]`, отсортированные по возрастанию цены |

### Пример ответа

```json
{
  "ticker_id": "BTC-USDT",
  "временная метка": 1784612408966,
  "bids": [
    ["66366.1", "4.0600"],
    ["66365.8", "9.6070"],
    ["66365.4", "6.4420"]
  ],
  "asks": [
    ["66366.8", "10.4390"],
    ["66367.0", "14.7450"],
    ["66367.3", "15.7020"]
  ]
}
```

{% hint style="info" %}
Если данные книги ордеров временно недоступны, конечная точка возвращает пустые `заявки на покупку` и `заявки на продажу` массивы, а не пустое тело ответа.
{% endhint %}