# Dzengi Market Data Inventory

## Контроль документа

| Свойство | Значение |
|----------|----------|
| Документ | Dzengi Market Data Inventory |
| Тип документа | Source Data Inventory |
| Версия | 1.0 |
| Статус | Draft |
| **Степень верификации** | **Documentation Verified** |
| Проект | Dzentra |
| Подсистема | Market Intelligence |
| Источник | Dzengi API |
| Язык | Русский |

---

## Статус документа

Настоящий документ представляет собой полную техническую инвентаризацию возможностей официального API биржи Dzengi.

Inventory фиксирует исключительно возможности получения данных через API и не содержит выводов о способах использования этих данных внутри архитектуры Dzentra.

Документ формируется на основании:

- официальной документации Dzengi REST API;
- официальной документации Dzengi WebSocket API;
- спецификации OpenAPI (Swagger);
- официальных примеров запросов;
- официальных примеров ответов;
- результатов анализа фактического поведения API.

До выпуска версии **Release** допускается уточнение описаний операций и структур данных по мере исследования API.

---

# Степень верификации

Настоящая редакция документа построена исключительно на основании официальной документации Dzengi:

- REST API Documentation;
- WebSocket Request API Documentation;
- WebSocket Stream API Documentation;
- OpenAPI (Swagger) Specification;
- официальных примеров запросов;
- официальных примеров ответов.

Фактическая проверка операций посредством выполнения реальных запросов к бирже Dzengi на момент подготовки настоящей редакции документа не проводилась.

По этой причине:

- обязательные параметры операций считаются соответствующими официальной документации;
- структуры Payload считаются соответствующими официальной документации;
- состав полей считается соответствующим официальной документации;
- описание операций основано исключительно на опубликованной спецификации API.

Настоящий документ имеет статус **Documentation Verified**.

После проведения практической проверки каждой операции с использованием реальных запросов и анализа фактических ответов API документ получит статус **Runtime Verified**.

Все расхождения между документацией и фактическим поведением API должны фиксироваться в последующих редакциях настоящего документа.

---

## Назначение

Настоящий документ предназначен для полной инвентаризации официального API Dzengi.

Документ фиксирует:

- доступные операции API;
- способы вызова операций;
- параметры запросов;
- структуры ответов;
- поля Payload;
- вложенные структуры данных;
- режимы получения данных;
- технические характеристики операций.

Настоящий документ **не определяет**:

- архитектуру Dzentra;
- внутреннюю информационную модель Dzentra;
- модель рынка;
- знания о рынке;
- способы анализа рынка;
- торговые алгоритмы;
- способы использования данных.

Все перечисленные вопросы рассматриваются в последующих архитектурных документах проекта.

---

## Цель

Цель настоящего документа — полностью определить технические возможности получения информации через официальный API Dzengi.

Настоящий Inventory является первичным техническим источником для разработки:

- Dzengi API Client;
- Dzentra Market Information Catalogue;
- Dzentra Market Knowledge Catalogue;
- подсистемы Market Intelligence;
- подсистемы Execution;
- подсистемы Portfolio;
- подсистемы Account Management.

---

## Основной вопрос документа

Настоящий документ отвечает только на один вопрос.

> **Какие операции, структуры данных и способы получения информации предоставляет официальный API Dzengi?**

---

## Источник информации

Настоящий документ построен исключительно на основании официальных материалов Dzengi.

Используются следующие источники:

- REST API Documentation;
- WebSocket Request API Documentation;
- WebSocket Stream API Documentation;
- OpenAPI (Swagger) Specification;
- официальные примеры запросов;
- официальные примеры ответов.

При возникновении расхождений между различными источниками приоритет имеют:

1. фактическое поведение API;
2. официальные примеры запросов и ответов;
3. спецификация OpenAPI (Swagger);
4. текстовая документация.

Предположения о внутренней реализации биржи в настоящем документе не используются.

---

## Поддерживаемые интерфейсы API

Настоящий документ рассматривает следующие интерфейсы взаимодействия с API Dzengi.

- REST API
- WebSocket Request API
- WebSocket Stream API

Каждый интерфейс рассматривается как самостоятельный способ взаимодействия с API и исследуется независимо.

---

## Поддерживаемые версии API

На момент подготовки настоящего документа официальная документация Dzengi содержит:

- REST API v1;
- REST API v2.

Если операция присутствует одновременно в нескольких версиях API и не имеет различий в структуре запросов и ответов, она описывается в настоящем документе один раз.

Различия между версиями фиксируются только при наличии технических отличий операций или структур данных.

---

---

## Правила описания API

Настоящий документ использует единые правила описания операций API.

Настоящие правила являются обязательными для всех разделов документа и не повторяются внутри описаний отдельных операций.

### Правило выбора версии API

Если операция присутствует одновременно в REST API v1 и REST API v2 и имеет одинаковые параметры запроса и одинаковую структуру ответа, операция описывается один раз.

Для криптовалютных инструментов предпочтительной рабочей версией считается **REST API v1**, поскольку:

- REST API v1 рекомендуется официальной документацией Dzengi;
- REST API v1 полностью покрывает криптовалютные инструменты;
- REST API v2 предназначен преимущественно для поддержки дополнительных типов инструментов;
- при совпадении структуры операций использование REST API v2 не предоставляет дополнительных преимуществ.

Отдельное описание REST API v2 создаётся только при наличии хотя бы одного из следующих условий:

- отличается состав параметров;
- отличается структура Payload;
- отличается состав полей ответа;
- отличается семантика данных;
- операция существует только в REST API v2;
- документация Dzengi требует использования REST API v2.

---

### Правило исследования API

Если официальная документация, OpenAPI (Swagger) и фактическое поведение API противоречат друг другу, в карточке операции фиксируется только подтверждённая информация.

Все неподтверждённые сведения указываются в разделе **Примечания** как требующие дополнительной проверки.

Настоящий документ не делает предположений о поведении API.

---

### Правило объединения REST API и WebSocket Request API

Если REST API и WebSocket Request API выполняют одну и ту же операцию и имеют:

- одинаковое назначение;
- одинаковые параметры запроса;
- одинаковую структуру ответа,

они рассматриваются как различные способы вызова одной операции и описываются одной карточкой.

---

### Правило описания WebSocket Stream

WebSocket Stream рассматривается как самостоятельная операция API.

Каждый Stream описывается отдельной карточкой независимо от наличия аналогичного REST endpoint или WebSocket Request метода.

---

### Правило именования операций

Во всём документе используется официальное имя операции Dzengi API.

Используются имена вида:

- `exchangeInfo`
- `ticker24hr`
- `account`
- `order.create`
- `order.edit`
- `order.cancel`
- `trades.subscribe`
- `depthMarketData.subscribe`

Путь REST endpoint и адрес WebSocket рассматриваются как способы вызова операции и приводятся только в разделе **Доступные вызовы**.

---

### Правило описания Payload

Раздел **Payload** содержит описание только полей верхнего уровня объекта ответа.

Если поле содержит объект или массив объектов, его внутренняя структура переносится в раздел **Структура Payload**.

---

### Правило описания структуры Payload

Все вложенные объекты и массивы описываются отдельно в соответствии с фактической структурой JSON.

Используется полное имя пути.

Например:

- `balances[]`
- `symbols[]`
- `symbols[].filters[]`
- `symbols[].marketModes[]`
- `positions[]`

Настоящий документ описывает структуру JSON и не определяет внутренние модели данных Dzentra.

---

### Правило обозначения структур данных

Если операция возвращает массив однотипных объектов, в разделе **Payload** для обозначения типа элементов массива используется условное имя структуры.

Например:

- `Currency[]`
- `Symbol[]`
- `Trade[]`
- `Order[]`
- `Position[]`

Данные обозначения используются исключительно для удобства чтения документа и не являются моделями данных Dzentra.

---

### Правило описания характеристик операции

Каждая операция содержит раздел **Характеристики операции**.

В данном разделе фиксируются технические свойства операции, непосредственно следующие из официальной документации или подтверждённые фактическим поведением API.

---

### Правило использования в Dzentra

Настоящий документ не определяет способы использования операций внутри Dzentra.

Во всех карточках используется единое значение:

> **Не определяется настоящим документом.**

Последующая интерпретация операций выполняется в документах:

- Dzentra Market Information Catalogue;
- Dzentra Market Knowledge Catalogue;
- Dzentra Architecture.

---

### Правило порядка операций

Документ разделён на тематические разделы.

Внутри каждого раздела операции располагаются в алфавитном порядке по официальному имени операции.

Например:

- `account`
- `aggTrades`
- `currencies`
- `depth`
- `exchangeInfo`

Алфавитная сортировка сохраняется независимо от:

- версии API;
- способа вызова операции;
- категории данных.

---

### Правило описания операций

Все операции настоящего документа описываются по единому стандарту.

Структура описания операции определяется разделом **Стандарт описания операций API** настоящего документа.

---

## Стандарт описания операций API

Все операции API описываются по единому стандарту.

Использование единой структуры обеспечивает:

- единообразие документа;
- удобство поиска информации;
- возможность автоматической обработки документа;
- возможность генерации моделей данных;
- возможность генерации клиентского кода;
- возможность дальнейшего построения Dzentra Market Information Catalogue.

### Структура описания операции

Каждая операция описывается в следующем порядке.

1. Назначение
2. Результат операции
3. Режим получения данных
4. Доступные вызовы
5. Версии API
6. Параметры запроса
7. Payload
8. Структура Payload
9. Характеристики операции
10. Использование в Dzentra
11. Примечания

---

### Результат операции

Краткое описание информации, возвращаемой операцией, либо результата её выполнения.

---

### Режим получения данных

Допустимые значения.

| Значение | Описание |
|----------|----------|
| Snapshot | Возвращает текущее состояние объекта на момент запроса. |
| Historical | Возвращает исторические данные за указанный период. |
| Stream | Передаёт данные в режиме реального времени. |
| Command | Выполняет действие и возвращает результат выполнения. |

---

### Доступные вызовы

Перечисляются все поддерживаемые способы вызова операции.

Пример.

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/exchangeInfo` |
| WS Request | `exchangeInfo` |

Если операция существует только в одном интерфейсе, указывается только он.

---

### Версии API

Перечисляются версии API, поддерживающие данную операцию.

Пример.

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

---

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

Описываются все параметры запроса.

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|

---

### Payload

Описываются только поля верхнего уровня объекта ответа.

| Поле | Тип | Описание |
|------|-----|----------|

---

### Структура Payload

Все вложенные объекты и массивы описываются отдельно в соответствии с фактической структурой JSON.

Например:

- `balances[]`
- `symbols[]`
- `symbols[].filters[]`
- `symbols[].permissions[]`
- `positions[]`

---

### Характеристики операции

Используется единая таблица.

| Свойство | Значение |
|----------|-----------|
| Авторизация | требуется / не требуется |
| API Key | требуется / не требуется |
| Подпись запроса | требуется / не требуется |
| Timestamp | требуется / не требуется |
| recvWindow | поддерживается / не поддерживается |
| Snapshot | да / нет |
| Historical | да / нет |
| Stream | да / нет |
| REST и WS Request эквивалентны | да / нет |

При необходимости таблица может быть дополнена дополнительными характеристиками, непосредственно следующими из официальной документации.

---

### Использование в Dzentra

Во всех карточках используется единое значение.

> **Не определяется настоящим документом.**

---

### Примечания

Содержат исключительно сведения, относящиеся к конкретной операции.

Общие правила, приведённые в начале документа, в данном разделе не повторяются.

---

## Содержание

Всего карточек операций: 33

### Market Reference Data (3)

- `currencies`
- `exchangeInfo`
- `time`

### Market Data (8)

- `aggTrades`
- `depth`
- `depthMarketData.subscribe`
- `klines`
- `marketData.subscribe`
- `OHLCMarketData.subscribe`
- `ticker24hr`
- `trades.subscribe`

### Trading Conditions (4)

- `fundingLimits`
- `leverageSettings`
- `tradingFees`
- `tradingLimits`

### Execution Data (11)

- `closeTradingPosition`
- `fetchOrder`
- `myTrades`
- `openOrders`
- `order.cancel`
- `order.create`
- `order.edit`
- `tradingPositions`
- `tradingPositionsHistory`
- `updateTradingOrder`
- `updateTradingPosition`

### Account Data (6)

- `account`
- `depositAddress`
- `deposits`
- `ledger`
- `transactions`
- `withdrawals`

### Infrastructure Services (1)

- `ping`

---

## Статистика документа

| Показатель | Значение |
|------------|---------:|
| Категорий данных | 6 |
| Карточек операций | 33 |
| Исследованных операций API | 61 |
| REST операций | 28 |
| WebSocket Request операций | 28 |
| WebSocket Stream операций | 4 |
| Infrastructure Services операций | 1 |

---

## Market Reference Data

**Назначение**

Содержит справочную информацию о рынке и торговых инструментах, необходимую для корректной интерпретации рыночных данных.

**Использование**

Данные раздела используются в качестве основы для обработки Market Data, проверки торговых параметров инструментов и подготовки торговых операций.

---

### currencies

#### Назначение

Получение справочной информации о валютах, поддерживаемых биржей Dzengi.

#### Результат операции

Возвращает сведения о валютах, доступных в системе Dzengi.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/currencies` |
| WS Request | `currencies` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **Currency**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `Currency[]` | Список валют. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `name` | string | Наименование валюты. |
| `displaySymbol` | string | Символ, используемый для отображения валюты. |
| `precision` | integer | Количество знаков после десятичной точки. |
| `type` | string | Тип валюты. |
| `minWithdrawal` | number | Минимально допустимая сумма вывода. |
| `maxWithdrawal` | number | Максимально допустимая сумма вывода. |
| `commissionMin` | number | Минимальная комиссия за вывод. |
| `commissionPercent` | number | Процентная комиссия за вывод. |
| `commissionFixed` | number | Фиксированная комиссия за вывод. |
| `minDeposit` | number | Минимально допустимая сумма пополнения. |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает справочную информацию о валютах, доступных в системе Dzengi.
- Верхний уровень ответа представляет собой массив объектов типа **Currency**.
- В официальной документации для данной операции вложенные структуры отсутствуют.

---

### exchangeInfo

#### Назначение

Получение справочной информации о торговых инструментах и правилах торговли, поддерживаемых биржей Dzengi.

#### Результат операции

Возвращает информацию о бирже, торговых инструментах, торговых фильтрах, поддерживаемых типах ордеров, ограничениях торговли и других параметрах, необходимых для корректной работы с рынком.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/exchangeInfo` |
| WS Request | `exchangeInfo` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да* |

\* Для криптовалютных инструментов рекомендуется использование REST API v1.

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Нет | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Нет | API-ключ пользователя. |
| `signature` | string | Нет | Цифровая подпись запроса. |

#### Payload

Возвращает объект **ExchangeInfo**.

| Поле | Тип | Описание |
|------|------|----------|
| `timezone` | string | Часовой пояс биржи. |
| `serverTime` | integer | Серверное время. |
| `rateLimits` | `RateLimit[]` | Ограничения API. |
| `exchangeFilters` | `ExchangeFilter[]` | Общие фильтры биржи. |
| `symbols` | `Symbol[]` | Список торговых инструментов. |

#### Структура Payload

##### rateLimits

| Поле | Тип | Описание |
|------|------|----------|
| *Определяется документацией Dzengi* |

##### exchangeFilters

| Поле | Тип | Описание |
|------|------|----------|
| *Определяется документацией Dzengi* |

##### symbols

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Код торгового инструмента. |
| `name` | string | Наименование инструмента. |
| `status` | string | Статус торговли. |
| `baseAsset` | string | Базовый актив. |
| `baseAssetPrecision` | integer | Точность базового актива. |
| `quoteAsset` | string | Котируемый актив. |
| `quoteAssetId` | string | Идентификатор котируемого актива. |
| `quotePrecision` | integer | Точность котируемого актива. |
| `orderTypes` | `string[]` | Поддерживаемые типы ордеров. |
| `filters` | `Filter[]` | Торговые фильтры инструмента. |
| `marketModes` | `MarketMode[]` | Поддерживаемые режимы торговли. |
| `marketType` | string | Тип рынка. |
| `country` | string | Страна. |
| `sector` | string | Сектор экономики. |
| `industry` | string | Отрасль. |
| `tradingHours` | string | Торговые часы. |
| `tickSize` | number | Размер тика. |
| `tickValue` | number | Стоимость тика. |
| `exchangeFee` | number | Комиссия биржи. |

##### symbols.filters

| Поле | Тип | Описание |
|------|------|----------|
| `filterType` | string | Тип фильтра. |
| `minQty` | string | Минимальное количество. |
| `maxQty` | string | Максимальное количество. |
| `stepSize` | string | Шаг изменения количества. |
| `minNotional` | string | Минимальная стоимость сделки. |

##### symbols.marketModes

| Поле | Тип | Описание |
|------|------|----------|
| *Структура определяется документацией Dzengi* |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает справочную информацию о бирже и торговых инструментах.
- Ответ содержит несколько вложенных структур данных.
- При авторизованном запросе состав доступных инструментов может зависеть от юрисдикции аккаунта пользователя.

---

### time

#### Назначение

Получение серверного времени биржи Dzengi.

#### Результат операции

Возвращает текущее серверное время биржи.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/time` |
| WS Request | `time` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

Отсутствуют.

#### Payload

Возвращает объект **ServerTime**.

| Поле | Тип | Описание |
|------|------|----------|
| `serverTime` | integer | Серверное время в миллисекундах Unix Epoch. |

#### Структура Payload

Отсутствует.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция не принимает параметров запроса.
- Возвращаемое значение используется для синхронизации времени между клиентом и сервером.
- Структура ответа состоит из одного поля.

---

## Market Data

**Назначение**

Содержит данные, непосредственно описывающие текущее или историческое состояние рынка.

**Использование**

Данные раздела являются основным источником информации о состоянии рынка и могут использоваться последующими документами Dzentra для построения информационной модели рынка, анализа рыночной ситуации и принятия торговых решений.

---

### aggTrades

#### Назначение

Получение списка агрегированных сделок по указанному торговому инструменту.

#### Результат операции

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

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/aggTrades` |
| WS Request | `aggTrades` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |

#### Payload

Возвращает массив объектов типа **AggregateTrade**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `AggregateTrade[]` | Список агрегированных сделок. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `a` | integer | Идентификатор агрегированной сделки. |
| `p` | string | Цена сделки. |
| `q` | string | Количество. |
| `T` | integer | Время сделки (Unix Timestamp, мс). |
| `m` | boolean | Признак того, что покупатель является maker. |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает агрегированные сделки в соответствии с документацией Dzengi.
- Поле `q` присутствует в официальной документации. Дополнительные особенности его использования настоящим документом не рассматриваются.
- Операция не является потоковой. Для получения данных в режиме реального времени используется отдельная операция `trades.subscribe`.

---

### depth

#### Назначение

Получение текущего состояния стакана заявок по указанному торговому инструменту.

#### Результат операции

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

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/depth` |
| WS Request | `depth` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |
| `limit` | integer | Нет | Максимальная глубина стакана. |

#### Payload

Возвращает объект **OrderBook**.

| Поле | Тип | Описание |
|------|------|----------|
| `lastUpdateId` | integer | Идентификатор состояния стакана. |
| `asks` | `OrderBookLevel[]` | Заявки на продажу. |
| `bids` | `OrderBookLevel[]` | Заявки на покупку. |

#### Структура Payload

##### asks

| Поле | Тип | Описание |
|------|------|----------|
| `[0]` | string | Цена. |
| `[1]` | string | Количество. |

##### bids

| Поле | Тип | Описание |
|------|------|----------|
| `[0]` | string | Цена. |
| `[1]` | string | Количество. |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает снимок (snapshot) текущего состояния стакана заявок.
- Каждая запись в массивах `asks` и `bids` представлена массивом из двух элементов: цены и количества.
- Для получения изменений стакана в режиме реального времени используется отдельная операция `depthMarketData.subscribe`.

---

### depthMarketData.subscribe

#### Назначение

Подписка на получение изменений стакана заявок по указанному торговому инструменту в режиме реального времени.

#### Результат операции

Возвращает поток событий, содержащих изменения текущего состояния стакана заявок.

#### Режим получения данных

**Stream**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| WS Stream | `depthMarketData.subscribe` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| WebSocket Stream API | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |

#### Payload

Возвращает объект **DepthMarketData**.

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `Data` | `DepthData` | Данные изменения стакана. |

#### Структура Payload

##### Data

| Поле | Тип | Описание |
|------|------|----------|
| `ts` | integer | Время события (Unix Timestamp, мс). |
| `Bid` | `object` | Уровни заявок на покупку. |
| `Ofr` | `object` | Уровни заявок на продажу. |

##### Data.Bid

*Структура определяется документацией Dzengi.*

##### Data.Ofr

*Структура определяется документацией Dzengi.*

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Да |
| REST и WS Request эквивалентны | Нет |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция использует WebSocket Stream API.
- Возвращает изменения состояния стакана заявок в режиме реального времени.
- Структура объектов `Bid` и `Ofr` официальной документацией полностью не раскрыта.
- Для получения полного состояния стакана используется операция `depth`.

---

### klines

#### Назначение

Получение исторических свечей (OHLC) по указанному торговому инструменту.

#### Результат операции

Возвращает список свечей, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/klines` |
| WS Request | `klines` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |
| `interval` | string | Да | Интервал свечи. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых свечей. |
| `priceType` | string | Нет | Тип цены. По умолчанию `bid`. |
| `type` | string | Нет | Тип возвращаемых данных. |

#### Payload

Возвращает массив объектов типа **Candle**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `Candle[]` | Список свечей. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `[0]` | integer | Время открытия свечи (Unix Timestamp, мс). |
| `[1]` | string | Цена открытия (*Open*). |
| `[2]` | string | Максимальная цена (*High*). |
| `[3]` | string | Минимальная цена (*Low*). |
| `[4]` | string | Цена закрытия (*Close*). |
| `[5]` | string | Объём (*Volume*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает исторические данные в виде последовательности свечей.
- Каждая свеча представлена массивом фиксированной структуры.
- В официальной документации свеча содержит шесть элементов массива.
- Для получения свечей в режиме реального времени используется отдельная операция `OHLCMarketData.subscribe`.

---

### marketData.subscribe

#### Назначение

Подписка на получение текущих рыночных котировок по указанному торговому инструменту в режиме реального времени.

#### Результат операции

Возвращает поток событий, содержащих текущие рыночные котировки.

#### Режим получения данных

**Stream**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| WS Stream | `marketData.subscribe` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| WebSocket Stream API | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |

#### Payload

Возвращает объект **MarketData**.

| Поле | Тип | Описание |
|------|------|----------|
| `symbolName` | string | Торговый инструмент. |
| `bid` | number | Лучшая цена покупки (*Best Bid*). |
| `bidQty` | number | Количество по лучшей цене покупки (*Best Bid Quantity*). |
| `ofr` | number | Лучшая цена продажи (*Best Ask*). |
| `ofrQty` | number | Количество по лучшей цене продажи (*Best Ask Quantity*). |
| `timestamp` | integer | Время формирования котировки (Unix Timestamp, мс). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Да |
| REST и WS Request эквивалентны | Нет |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция использует WebSocket Stream API.
- Возвращает поток текущих рыночных котировок в режиме реального времени.
- Каждое сообщение содержит текущее состояние лучших цен покупки и продажи для торгового инструмента.
- Поток не содержит историю изменений котировок.

---

### OHLCMarketData.subscribe

#### Назначение

Подписка на получение свечей (OHLC) по указанному торговому инструменту в режиме реального времени.

#### Результат операции

Возвращает поток событий, содержащих текущие данные свечей (OHLC).

#### Режим получения данных

**Stream**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| WS Stream | `OHLCMarketData.subscribe` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| WebSocket Stream API | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |
| `interval` | string | Да | Интервал свечи. |

#### Payload

Возвращает объект **Candle**.

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `interval` | string | Интервал свечи. |
| `T` | integer | Время открытия свечи (Unix Timestamp, мс). |
| `O` | number | Цена открытия (*Open*). |
| `H` | number | Максимальная цена (*High*). |
| `L` | number | Минимальная цена (*Low*). |
| `C` | number | Цена закрытия (*Close*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Да |
| REST и WS Request эквивалентны | Нет |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция использует WebSocket Stream API.
- Возвращает поток свечей (OHLC) в режиме реального времени.
- Каждое сообщение относится к одной свече выбранного интервала.
- В официальном примере документации поле объёма (*Volume*) отсутствует.
- Если состав сообщения будет отличаться в фактических ответах API, описание может быть уточнено после практической проверки.

---

### ticker24hr

#### Назначение

Получение статистики торгов по указанному торговому инструменту за последние 24 часа.

#### Результат операции

Возвращает статистические показатели торгов за последние 24 часа.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/ticker/24hr` |
| WS Request | `ticker/24hr` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Нет | Торговый инструмент. Если параметр не указан, может возвращаться статистика по нескольким инструментам. |

#### Payload

Возвращает объект **Ticker24hr**.

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `priceChange` | string | Изменение цены (*Price Change*). |
| `priceChangePercent` | string | Изменение цены в процентах (*Price Change Percent*). |
| `weightedAvgPrice` | string | Средневзвешенная цена (*Weighted Average Price*). |
| `prevClosePrice` | string | Предыдущая цена закрытия (*Previous Close Price*). |
| `lastPrice` | string | Последняя цена (*Last Price*). |
| `lastQty` | string | Количество последней сделки (*Last Quantity*). |
| `bidPrice` | string | Лучшая цена покупки (*Best Bid*). |
| `askPrice` | string | Лучшая цена продажи (*Best Ask*). |
| `openPrice` | string | Цена открытия (*Open Price*). |
| `highPrice` | string | Максимальная цена (*High Price*). |
| `lowPrice` | string | Минимальная цена (*Low Price*). |
| `volume` | string | Объём (*Volume*). |
| `quoteVolume` | string | Объём в котируемом активе (*Quote Volume*). |
| `openTime` | integer | Время открытия периода (Unix Timestamp, мс). |
| `closeTime` | integer | Время окончания периода (Unix Timestamp, мс). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает статистику торгов за последние 24 часа.
- Если параметр `symbol` не указан, операция может вернуть статистику сразу по нескольким торговым инструментам.
- Значения рассчитываются для скользящего 24-часового периода (*24-hour rolling window*).

---

### trades.subscribe

#### Назначение

Подписка на получение информации о сделках по указанному торговому инструменту в режиме реального времени.

#### Результат операции

Возвращает поток событий, содержащих информацию о совершаемых сделках.

#### Режим получения данных

**Stream**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| WS Stream | `trades.subscribe` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| WebSocket Stream API | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |

#### Payload

Возвращает объект **Trade**.

| Поле | Тип | Описание |
|------|------|----------|
| `price` | number | Цена сделки (*Trade Price*). |
| `size` | number | Объём сделки (*Trade Size*). |
| `id` | integer | Идентификатор сделки (*Trade ID*). |
| `ts` | integer | Время сделки (Unix Timestamp, мс). |
| `symbol` | string | Торговый инструмент. |
| `orderId` | string | Идентификатор ордера (*Order ID*). |
| `clientOrderId` | string | Клиентский идентификатор ордера (*Client Order ID*). |
| `buyer` | boolean | Признак стороны покупателя (*Buyer Flag*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Да |
| REST и WS Request эквивалентны | Нет |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция использует WebSocket Stream API.
- Возвращает поток сделок в режиме реального времени.
- Каждое сообщение описывает отдельную сделку.
- Для получения истории агрегированных сделок используются операции `aggTrades` (REST API / WebSocket Request API).

---

## Trading Conditions

**Назначение**

Содержит информацию о торговых условиях, ограничениях и правилах, применяемых биржей Dzengi при исполнении торговых операций.

**Использование**

Данные раздела могут использоваться последующими документами Dzentra для проверки допустимости торговых операций, расчёта торговых параметров и соблюдения ограничений биржи.

---

### fundingLimits

#### Назначение

Получение информации об ограничениях операций пополнения и вывода средств.

#### Результат операции

Возвращает список ограничений, применяемых к операциям пополнения и вывода средств.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/fundingLimits` |
| WS Request | `fundingLimits` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **FundingLimit**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `FundingLimit[]` | Список ограничений операций пополнения и вывода средств. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `paymentOption` | string | Способ пополнения или вывода средств (*Payment Option*). |
| `accountCurrency` | string | Валюта аккаунта (*Account Currency*). |
| `minWithdrawal` | string | Минимально допустимая сумма вывода (*Minimum Withdrawal*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает ограничения, действующие для операций пополнения и вывода средств.
- Ответ представляет собой массив однотипных объектов.
- Вложенные структуры в официальной документации отсутствуют.

---

### leverageSettings

#### Назначение

Получение доступных настроек кредитного плеча для указанного торгового инструмента.

#### Результат операции

Возвращает доступные значения кредитного плеча для указанного торгового инструмента.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/leverageSettings` |
| WS Request | `leverageSettings` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `symbol` | string | Да | Торговый инструмент. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **LeverageSettings**.

| Поле | Тип | Описание |
|------|------|----------|
| `values` | `integer[]` | Доступные значения кредитного плеча. |
| `value` | integer | Значение кредитного плеча по умолчанию. |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает настройки кредитного плеча для указанного торгового инструмента.
- Ответ содержит значение кредитного плеча по умолчанию и перечень доступных значений.
- Вложенные структуры в официальной документации отсутствуют.

---

### tradingFees

#### Назначение

Получение информации о торговых комиссиях для доступных торговых инструментов.

#### Результат операции

Возвращает список торговых комиссий, применяемых биржей Dzengi.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/tradingFees` |
| WS Request | `tradingFees` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **TradingFee**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `TradingFee[]` | Список торговых комиссий. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `name` | string | Наименование торгового инструмента. |
| `fee` | number | Размер торговой комиссии (*Trading Fee*). |
| `overnightRates` | object | Ставки переноса позиции (*Overnight Rates*). |
| `overnightFeeTimestamp` | integer | Время применения ставок переноса (Unix Timestamp, мс). |

##### overnightRates

*Структура определяется документацией Dzengi.*

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает торговые комиссии для доступных торговых инструментов.
- Ответ представляет собой массив однотипных объектов.
- Структура объекта `overnightRates` в официальной документации полностью не раскрыта.

---

### tradingLimits

#### Назначение

Получение информации о торговых ограничениях для доступных торговых инструментов.

#### Результат операции

Возвращает список торговых ограничений, применяемых биржей Dzengi.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/tradingLimits` |
| WS Request | `tradingLimits` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **TradingLimit**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `TradingLimit[]` | Список торговых ограничений. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `name` | string | Наименование торгового инструмента. |
| `lastPrice` | number | Последняя цена (*Last Price*). |
| `minVolume` | number | Минимальный объём сделки (*Minimum Volume*). |
| `maxVolume` | number | Максимальный объём сделки (*Maximum Volume*). |
| `minStep` | number | Минимальный шаг изменения объёма (*Minimum Step*). |
| `tickSize` | number | Размер тика (*Tick Size*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает торговые ограничения для доступных торговых инструментов.
- Ответ представляет собой массив однотипных объектов.
- Вложенные структуры в официальной документации отсутствуют.

---

## Execution Data

**Назначение**

Содержит операции, связанные с созданием, изменением, исполнением и закрытием торговых ордеров и позиций.

**Использование**

Данные раздела могут использоваться последующими документами Dzentra для реализации торговых операций, управления позициями и получения информации об исполнении ордеров.

### Command Operations

- closeTradingPosition
- order.cancel
- order.create
- order.edit
- updateTradingOrder
- updateTradingPosition

### Query Operations

- fetchOrder
- myTrades
- openOrders
- tradingPositions
- tradingPositionsHistory

---

### closeTradingPosition

#### Назначение

Закрытие открытой торговой позиции.

#### Результат операции

Инициирует закрытие торговой позиции и возвращает информацию о результате регистрации запроса.

#### Режим получения данных

**Command**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `POST /api/{version}/closeTradingPosition` |
| WS Request | `closeTradingPosition` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `positionId` | string | Да | Идентификатор торговой позиции. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **CloseTradingPositionResponse**.

| Поле | Тип | Описание |
|------|------|----------|
| `request` | `CloseTradingPositionRequest[]` | Список зарегистрированных запросов на закрытие позиции. |

#### Структура Payload

##### request

| Поле | Тип | Описание |
|------|------|----------|
| `id` | integer | Идентификатор запроса. |
| `accountId` | string / integer | Идентификатор аккаунта. |
| `instrumentId` | string | Идентификатор торгового инструмента. |
| `rqType` | string | Тип запроса (*Request Type*). |
| `state` | string | Состояние обработки запроса (*Request State*). |
| `createdTimestamp` | integer | Время создания запроса (Unix Timestamp, мс). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к командам исполнения торговых операций (*Command*).
- Ответ содержит информацию о зарегистрированном запросе на закрытие позиции.

---

### fetchOrder

#### Назначение

Получение информации о торговом ордере по его идентификатору.

#### Результат операции

Возвращает информацию о торговом ордере, соответствующем параметрам запроса.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/fetchOrder` |
| WS Request | `fetchOrder` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `symbol` | string | Да | Торговый инструмент. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `orderId` | string | Да | Идентификатор торгового ордера. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **Order**.

| Поле | Тип | Описание |
|------|------|----------|
| `accountId` | string / integer | Идентификатор аккаунта. |
| `orderId` | string | Идентификатор ордера. |
| `quantity` | number | Количество (*Quantity*). |
| `price` | number | Цена (*Price*). |
| `timestamp` | integer | Время создания ордера (Unix Timestamp, мс). |
| `status` | string | Статус ордера (*Order Status*). |
| `type` | string | Тип ордера (*Order Type*). |
| `expireTime` | integer | Время истечения действия ордера (Unix Timestamp, мс). |
| `timeInForceType` | string | Политика исполнения ордера (*Time In Force*). |
| `side` | string | Сторона ордера (*Order Side*). |
| `guaranteedStopLoss` | boolean | Использование гарантированного Stop Loss (*Guaranteed Stop Loss*). |
| `margin` | number | Требуемая маржа (*Margin*). |
| `takeProfit` | number | Уровень Take Profit. |
| `takeProfitType` | string | Тип Take Profit. |
| `stopLoss` | number | Уровень Stop Loss. |
| `stopLossType` | string | Тип Stop Loss. |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает информацию о торговом ордере по его идентификатору.
- В официальной OpenAPI-спецификации для модели ответа присутствует `resolver error`, поэтому состав полей может быть уточнён после проверки фактического ответа API.

---

### myTrades

#### Назначение

Получение информации о сделках пользователя по указанному торговому инструменту.

#### Результат операции

Возвращает список сделок пользователя, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/myTrades` |
| WS Request | `myTrades` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `symbol` | string | Да | Торговый инструмент. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **Trade**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `Trade[]` | Список сделок пользователя. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `orderId` | string | Идентификатор ордера (*Order ID*). |
| `price` | string | Цена сделки (*Trade Price*). |
| `qty` | string | Количество (*Quantity*). |
| `quoteQty` | string | Количество в котируемом активе (*Quote Quantity*). |
| `commission` | string | Комиссия (*Commission*). |
| `commissionAsset` | string | Актив комиссии (*Commission Asset*). |
| `time` | integer | Время сделки (Unix Timestamp, мс). |
| `maker` | boolean | Признак Maker (*Maker Flag*). |
| `buyer` | boolean | Признак покупателя (*Buyer Flag*). |
| `isBuyer` | boolean | Признак стороны покупателя (*Is Buyer*). |
| `isMaker` | boolean | Признак стороны Maker (*Is Maker*). |
| `id` | integer | Идентификатор сделки (*Trade ID*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает историю сделок пользователя по указанному торговому инструменту.
- Ответ представляет собой массив однотипных объектов.
- Операция возвращает только сделки авторизованного пользователя.

---

### openOrders

#### Назначение

Получение списка открытых торговых ордеров.

#### Результат операции

Возвращает список открытых торговых ордеров, соответствующих параметрам запроса.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/openOrders` |
| WS Request | `openOrders` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `symbol` | string | Нет | Торговый инструмент. Если параметр не указан, возвращаются открытые ордера по всем доступным инструментам. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **Order**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `Order[]` | Список открытых торговых ордеров. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `orderId` | string | Идентификатор ордера (*Order ID*). |
| `price` | string | Цена ордера (*Order Price*). |
| `origQty` | string | Исходное количество (*Original Quantity*). |
| `executedQty` | string | Исполненное количество (*Executed Quantity*). |
| `status` | string | Статус ордера (*Order Status*). |
| `timeInForce` | string | Политика исполнения ордера (*Time In Force*). |
| `type` | string | Тип ордера (*Order Type*). |
| `side` | string | Сторона ордера (*Order Side*). |
| `time` | integer | Время создания ордера (Unix Timestamp, мс). |
| `updateTime` | integer | Время последнего обновления ордера (Unix Timestamp, мс). |
| `leverage` | boolean | Признак использования кредитного плеча (*Leverage Flag*). |
| `working` | boolean | Признак активного ордера (*Working Flag*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает только открытые торговые ордера авторизованного пользователя.
- Ответ представляет собой массив однотипных объектов.
- Если параметр `symbol` не указан, документация Dzengi рекомендует использовать операцию с осторожностью, поскольку может быть возвращён полный список открытых ордеров пользователя.

---

### order.cancel

#### Назначение

Отмена открытого торгового ордера.

#### Результат операции

Инициирует отмену торгового ордера и возвращает информацию о результате обработки запроса.

#### Режим получения данных

**Command**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `DELETE /api/{version}/order` |
| WS Request | `order.cancel` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `symbol` | string | Да | Торговый инструмент. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `orderId` | string | Да | Идентификатор торгового ордера. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **Order**.

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `orderId` | string | Идентификатор ордера (*Order ID*). |
| `price` | string | Цена ордера (*Order Price*). |
| `origQty` | string | Исходное количество (*Original Quantity*). |
| `executedQty` | string | Исполненное количество (*Executed Quantity*). |
| `status` | string | Статус ордера (*Order Status*). |
| `timeInForce` | string | Политика исполнения ордера (*Time In Force*). |
| `type` | string | Тип ордера (*Order Type*). |
| `side` | string | Сторона ордера (*Order Side*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к командам исполнения торговых операций (*Command*).
- Выполняет отмену открытого торгового ордера.
- Ответ содержит информацию об ордере после обработки команды отмены.

---

### order.create

#### Назначение

Создание нового торгового ордера.

#### Результат операции

Инициирует создание торгового ордера и возвращает информацию о результате обработки запроса.

#### Режим получения данных

**Command**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `POST /api/{version}/order` |
| WS Request | `order.create` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `symbol` | string | Да | Торговый инструмент. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `type` | string | Да | Тип ордера (*Order Type*). |
| `quantity` | number | Да | Количество (*Quantity*). |
| `side` | string | Да | Сторона ордера (*Order Side*). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |
| `price` | number | Нет | Цена ордера (*Order Price*). |
| `accountId` | string | Нет | Идентификатор торгового аккаунта. |
| `leverage` | integer | Нет | Кредитное плечо (*Leverage*). |
| `stopLoss` | number | Нет | Уровень Stop Loss. |
| `takeProfit` | number | Нет | Уровень Take Profit. |
| `guaranteedStopLoss` | boolean | Нет | Использование гарантированного Stop Loss (*Guaranteed Stop Loss*). |
| `trailingStopLoss` | boolean | Нет | Использование трейлинг Stop Loss (*Trailing Stop Loss*). |
| `newOrderRespType` | string | Нет | Тип возвращаемого ответа (*Response Type*). |
| `expireTimestamp` | integer | Нет | Время окончания действия ордера (Unix Timestamp, мс). |
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |

#### Payload

Возвращает объект **Order**.

| Поле | Тип | Описание |
|------|------|----------|
| `symbol` | string | Торговый инструмент. |
| `orderId` | string | Идентификатор ордера (*Order ID*). |
| `transactTime` | integer | Время регистрации ордера (Unix Timestamp, мс). |
| `price` | string | Цена ордера (*Order Price*). |
| `origQty` | string | Исходное количество (*Original Quantity*). |
| `executedQty` | string | Исполненное количество (*Executed Quantity*). |
| `status` | string | Статус ордера (*Order Status*). |
| `timeInForce` | string | Политика исполнения ордера (*Time In Force*). |
| `type` | string | Тип ордера (*Order Type*). |
| `side` | string | Сторона ордера (*Order Side*). |
| `margin` | number | Требуемая маржа (*Margin*). |
| `stopLoss` | number | Уровень Stop Loss. |
| `takeProfit` | number | Уровень Take Profit. |
| `rejectMessage` | string | Сообщение об отказе (*Reject Message*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к командам исполнения торговых операций (*Command*).
- Выполняет создание нового торгового ордера.
- В зависимости от типа ордера часть параметров запроса может быть необязательной.
- Ответ содержит информацию о зарегистрированном торговом ордере либо сообщение об отказе в его создании.

---

### order.edit

#### Назначение

Изменение параметров существующего торгового ордера.

#### Результат операции

Инициирует изменение торгового ордера и возвращает информацию о результате обработки запроса.

#### Режим получения данных

**Command**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `PUT /api/{version}/order` |
| WS Request | `order.edit` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `orderId` | string | Да | Идентификатор торгового ордера. |
| `price` | number | Нет | Новая цена ордера (*Order Price*). |
| `expireTimestamp` | integer | Нет | Новое время окончания действия ордера (Unix Timestamp, мс). |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **Order**.

| Поле | Тип | Описание |
|------|------|----------|
| `orderId` | string | Идентификатор изменённого ордера (*Order ID*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к командам исполнения торговых операций (*Command*).
- Позволяет изменить параметры существующего торгового ордера.
- Согласно официальной документации поддерживается изменение цены ордера и времени окончания его действия.
- Ответ содержит идентификатор успешно обработанного ордера.

---

### tradingPositions

#### Назначение

Получение списка открытых торговых позиций пользователя.

#### Результат операции

Возвращает список открытых торговых позиций пользователя.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/tradingPositions` |
| WS Request | `tradingPositions` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **TradingPositions**.

| Поле | Тип | Описание |
|------|------|----------|
| `positions` | `Position[]` | Список открытых торговых позиций. |

#### Структура Payload

##### positions

| Поле | Тип | Описание |
|------|------|----------|
| `id` | string | Идентификатор позиции (*Position ID*). |
| `accountId` | string / integer | Идентификатор аккаунта. |
| `symbol` | string | Торговый инструмент. |
| `instrumentId` | string | Идентификатор торгового инструмента. |
| `type` | string | Тип позиции (*Position Type*). |
| `state` | string | Состояние позиции (*Position State*). |
| `openPrice` | number | Цена открытия (*Open Price*). |
| `openQuantity` | number | Объём открытия (*Open Quantity*). |
| `openTimestamp` | integer | Время открытия позиции (Unix Timestamp, мс). |
| `margin` | number | Используемая маржа (*Margin*). |
| `stopLoss` | number | Уровень Stop Loss. |
| `takeProfit` | number | Уровень Take Profit. |
| `swap` | number | Начисленный своп (*Swap*). |
| `fee` | number | Торговая комиссия (*Trading Fee*). |
| `rpl` | number | Реализованная прибыль или убыток (*Realized P/L*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает только открытые торговые позиции авторизованного пользователя.
- Ответ содержит массив объектов, описывающих текущие открытые позиции.
- Состав полей соответствует официальной документации Dzengi и может быть уточнён после проверки фактических ответов API.

---

### tradingPositionsHistory

#### Назначение

Получение истории торговых позиций пользователя.

#### Результат операции

Возвращает список исторических торговых позиций пользователя, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/tradingPositionsHistory` |
| WS Request | `tradingPositionsHistory` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `symbol` | string | Нет | Торговый инструмент. |
| `from` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `to` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **TradingPositionsHistory**.

| Поле | Тип | Описание |
|------|------|----------|
| `history` | `Position[]` | Список исторических торговых позиций. |

#### Структура Payload

##### history

| Поле | Тип | Описание |
|------|------|----------|
| `id` | string | Идентификатор позиции (*Position ID*). |
| `accountId` | string / integer | Идентификатор аккаунта. |
| `symbol` | string | Торговый инструмент. |
| `instrumentId` | string | Идентификатор торгового инструмента. |
| `type` | string | Тип позиции (*Position Type*). |
| `state` | string | Состояние позиции (*Position State*). |
| `openPrice` | number | Цена открытия (*Open Price*). |
| `closePrice` | number | Цена закрытия (*Close Price*). |
| `openQuantity` | number | Объём открытия (*Open Quantity*). |
| `closeQuantity` | number | Объём закрытия (*Close Quantity*). |
| `openTimestamp` | integer | Время открытия позиции (Unix Timestamp, мс). |
| `closeTimestamp` | integer | Время закрытия позиции (Unix Timestamp, мс). |
| `margin` | number | Используемая маржа (*Margin*). |
| `fee` | number | Торговая комиссия (*Trading Fee*). |
| `swap` | number | Начисленный своп (*Swap*). |
| `rpl` | number | Реализованная прибыль или убыток (*Realized P/L*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает историю торговых позиций авторизованного пользователя.
- Ответ содержит массив объектов, описывающих закрытые торговые позиции.
- При указании параметров периода возвращаются только позиции, удовлетворяющие заданным условиям.
- Состав полей соответствует официальной документации Dzengi и может быть уточнён после проверки фактических ответов API.

---

### updateTradingOrder

#### Назначение

Изменение параметров существующего торгового ордера.

#### Результат операции

Инициирует изменение торгового ордера и возвращает информацию о результате обработки запроса.

#### Режим получения данных

**Command**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `POST /api/{version}/updateTradingOrder` |
| WS Request | `updateTradingOrder` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `orderId` | string | Да | Идентификатор торгового ордера. |
| `signature` | string | Да | Цифровая подпись запроса. |
| `newPrice` | number | Нет | Новая цена ордера (*New Price*). |
| `stopLoss` | number | Нет | Новый уровень Stop Loss. |
| `takeProfit` | number | Нет | Новый уровень Take Profit. |
| `guaranteedStopLoss` | boolean | Нет | Использование гарантированного Stop Loss (*Guaranteed Stop Loss*). |
| `trailingStopLoss` | boolean | Нет | Использование трейлинг Stop Loss (*Trailing Stop Loss*). |
| `profitDistance` | number | Нет | Расстояние до Take Profit (*Profit Distance*). |
| `stopDistance` | number | Нет | Расстояние до Stop Loss (*Stop Distance*). |
| `expireTimestamp` | integer | Нет | Новое время окончания действия ордера (Unix Timestamp, мс). |
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |

#### Payload

Возвращает объект **UpdateTradingOrderResponse**.

| Поле | Тип | Описание |
|------|------|----------|
| `requestId` | string / integer | Идентификатор запроса. |
| `state` | string | Состояние обработки запроса (*Request State*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к командам исполнения торговых операций (*Command*).
- Позволяет изменить параметры существующего торгового ордера.
- Если параметры `guaranteedStopLoss` или `trailingStopLoss` не переданы, официальная документация Dzengi указывает, что они принимают значение `false`.
- Ответ содержит информацию о зарегистрированном запросе на изменение ордера.

---

### updateTradingPosition

#### Назначение

Изменение параметров существующей торговой позиции.

#### Результат операции

Инициирует изменение торговой позиции и возвращает информацию о результате обработки запроса.

#### Режим получения данных

**Command**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `POST /api/{version}/updateTradingPosition` |
| WS Request | `updateTradingPosition` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `positionId` | string | Да | Идентификатор торговой позиции. |
| `signature` | string | Да | Цифровая подпись запроса. |
| `stopLoss` | number | Нет | Новый уровень Stop Loss. |
| `takeProfit` | number | Нет | Новый уровень Take Profit. |
| `guaranteedStopLoss` | boolean | Нет | Использование гарантированного Stop Loss (*Guaranteed Stop Loss*). |
| `trailingStopLoss` | boolean | Нет | Использование трейлинг Stop Loss (*Trailing Stop Loss*). |
| `profitDistance` | number | Нет | Расстояние до Take Profit (*Profit Distance*). |
| `stopDistance` | number | Нет | Расстояние до Stop Loss (*Stop Distance*). |
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |

#### Payload

Возвращает объект **UpdateTradingPositionResponse**.

| Поле | Тип | Описание |
|------|------|----------|
| `requestId` | string / integer | Идентификатор запроса. |
| `state` | string | Состояние обработки запроса (*Request State*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к командам исполнения торговых операций (*Command*).
- Позволяет изменить параметры существующей торговой позиции.
- Если параметры `guaranteedStopLoss` или `trailingStopLoss` не переданы, официальная документация Dzengi указывает, что они принимают значение `false`.
- Ответ содержит информацию о зарегистрированном запросе на изменение торговой позиции.

---

## Account Data

**Назначение**

Содержит операции, связанные с торговым аккаунтом пользователя, его балансами, пополнениями, выводом средств и историей финансовых операций.

**Использование**

Данные раздела могут использоваться последующими документами Dzentra для управления торговым аккаунтом, расчёта доступных средств и ведения финансовой истории пользователя.

---

### account

#### Назначение

Получение текущей информации о торговом аккаунте пользователя.

#### Результат операции

Возвращает текущие параметры аккаунта и список доступных балансов пользователя.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/account` |
| WS Request | `account` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `showZeroBalance` | boolean | Нет | Включить отображение нулевых балансов. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **Account**.

| Поле | Тип | Описание |
|------|------|----------|
| `makerCommission` | number | Комиссия Maker (*Maker Commission*). |
| `takerCommission` | number | Комиссия Taker (*Taker Commission*). |
| `buyerCommission` | number | Комиссия покупателя (*Buyer Commission*). |
| `sellerCommission` | number | Комиссия продавца (*Seller Commission*). |
| `canTrade` | boolean | Разрешена торговля. |
| `canWithdraw` | boolean | Разрешён вывод средств. |
| `canDeposit` | boolean | Разрешено пополнение счёта. |
| `updateTime` | integer | Время последнего обновления (Unix Timestamp, мс). |
| `userId` | integer | Идентификатор пользователя. |
| `affiliateId` | string | Идентификатор партнёрской программы. |
| `balances` | `Balance[]` | Список балансов пользователя. |

#### Структура Payload

##### balances

| Поле | Тип | Описание |
|------|------|----------|
| `accountId` | string | Идентификатор аккаунта. |
| `asset` | string | Актив. |
| `free` | number | Свободный баланс (*Free Balance*). |
| `locked` | number | Заблокированный баланс (*Locked Balance*). |
| `collateralCurrency` | boolean | Признак обеспечения (*Collateral Currency*). |
| `default` | boolean | Признак основного аккаунта (*Default Account*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает текущее состояние торгового аккаунта пользователя.
- Ответ содержит параметры аккаунта и список балансов.
- Структура массива `balances` полностью описана официальной документацией Dzengi.

---

### depositAddress

#### Назначение

Получение адреса для пополнения счёта по указанной валюте.

#### Результат операции

Возвращает адрес и дополнительные реквизиты, необходимые для пополнения счёта.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/depositAddress` |
| WS Request | `depositAddress` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `coin` | string | Да | Валюта, для которой требуется получить адрес пополнения. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **DepositAddress**.

| Поле | Тип | Описание |
|------|------|----------|
| `address` | string | Адрес для пополнения счёта. |
| `addressLegacy` | string | Legacy-адрес для пополнения счёта. |
| `destinationTag` | string | Дополнительный идентификатор перевода (*Destination Tag / Memo*). |

#### Структура Payload

Вложенные структуры отсутствуют.

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает реквизиты для пополнения счёта выбранной валютой.
- Для некоторых валют может использоваться дополнительный идентификатор перевода (*Destination Tag / Memo*).
- Вложенные структуры в официальной документации отсутствуют.

---

### deposits

#### Назначение

Получение истории операций пополнения счёта пользователя.

#### Результат операции

Возвращает список операций пополнения счёта, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/deposits` |
| WS Request | `deposits` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **Deposit**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `Deposit[]` | Список операций пополнения счёта. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `id` | integer | Идентификатор операции. |
| `balance` | number | Баланс после выполнения операции (*Balance*). |
| `amount` | number | Сумма операции (*Amount*). |
| `currency` | string | Валюта операции (*Currency*). |
| `type` | string | Тип операции (*Operation Type*). |
| `timestamp` | integer | Время выполнения операции (Unix Timestamp, мс). |
| `commission` | number | Комиссия (*Commission*). |
| `paymentMethod` | string | Способ проведения операции (*Payment Method*). |
| `status` | string | Статус операции (*Operation Status*). |
| `blockchainTransactionHash` | string | Хэш транзакции в блокчейне (*Blockchain Transaction Hash*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает историю пополнений авторизованного пользователя.
- Ответ представляет собой массив однотипных объектов.
- Состав полей соответствует официальной документации Dzengi и может быть уточнён после проверки фактических ответов API.

---

### ledger

#### Назначение

Получение истории операций по бухгалтерскому журналу (*Ledger*) пользователя.

#### Результат операции

Возвращает список записей бухгалтерского журнала, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/ledger` |
| WS Request | `ledger` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **LedgerEntry**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `LedgerEntry[]` | Список записей бухгалтерского журнала. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `id` | integer | Идентификатор записи. |
| `balance` | number | Баланс после выполнения операции (*Balance*). |
| `amount` | number | Сумма операции (*Amount*). |
| `currency` | string | Валюта операции (*Currency*). |
| `type` | string | Тип операции (*Operation Type*). |
| `timestamp` | integer | Время выполнения операции (Unix Timestamp, мс). |
| `commission` | number | Комиссия (*Commission*). |
| `status` | string | Статус операции (*Operation Status*). |
| `paymentMethod` | string | Способ проведения операции (*Payment Method*). |
| `blockchainTransactionHash` | string | Хэш транзакции в блокчейне (*Blockchain Transaction Hash*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает бухгалтерский журнал (*Ledger*) авторизованного пользователя.
- Ответ представляет собой массив однотипных объектов.
- Назначение отдельных типов операций (`type`) определяется правилами учёта Dzengi и выходит за рамки настоящего документа.
- Состав полей соответствует официальной документации Dzengi и может быть уточнён после проверки фактических ответов API.

---

### transactions

#### Назначение

Получение истории финансовых транзакций пользователя.

#### Результат операции

Возвращает список финансовых транзакций, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/transactions` |
| WS Request | `transactions` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает объект **Transactions**.

| Поле | Тип | Описание |
|------|------|----------|
| `transactions` | `Transaction[]` | Список финансовых транзакций. |

#### Структура Payload

##### transactions

| Поле | Тип | Описание |
|------|------|----------|
| `id` | integer | Идентификатор транзакции. |
| `balance` | number | Баланс после выполнения операции (*Balance*). |
| `amount` | number | Сумма операции (*Amount*). |
| `currency` | string | Валюта операции (*Currency*). |
| `type` | string | Тип операции (*Operation Type*). |
| `timestamp` | integer | Время выполнения операции (Unix Timestamp, мс). |
| `commission` | number | Комиссия (*Commission*). |
| `paymentMethod` | string | Способ проведения операции (*Payment Method*). |
| `status` | string | Статус операции (*Operation Status*). |
| `blockchainTransactionHash` | string | Хэш транзакции в блокчейне (*Blockchain Transaction Hash*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает историю финансовых транзакций авторизованного пользователя.
- Ответ содержит массив объектов, описывающих отдельные финансовые транзакции.
- Назначение отдельных типов операций (`type`) определяется правилами учёта Dzengi и выходит за рамки настоящего документа.
- Состав полей соответствует официальной документации Dzengi и может быть уточнён после проверки фактических ответов API.

---

### withdrawals

#### Назначение

Получение истории операций вывода средств пользователя.

#### Результат операции

Возвращает список операций вывода средств, соответствующих параметрам запроса.

#### Режим получения данных

**Historical**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| REST | `GET /api/{version}/withdrawals` |
| WS Request | `withdrawals` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| REST API v1 | Да |
| REST API v2 | Да |

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

| Параметр | Тип | Обязательный | Описание |
|----------|-----|--------------|----------|
| `recvWindow` | integer | Нет | Допустимое окно времени обработки запроса. |
| `timestamp` | integer | Да | Время формирования запроса (Unix Timestamp, мс). |
| `X-MBX-APIKEY` | string | Да | API-ключ пользователя. |
| `startTime` | integer | Нет | Начало периода (Unix Timestamp, мс). |
| `endTime` | integer | Нет | Конец периода (Unix Timestamp, мс). |
| `limit` | integer | Нет | Максимальное количество возвращаемых записей. |
| `signature` | string | Да | Цифровая подпись запроса. |

#### Payload

Возвращает массив объектов типа **Withdrawal**.

| Поле | Тип | Описание |
|------|------|----------|
| `[]` | `Withdrawal[]` | Список операций вывода средств. |

#### Структура Payload

| Поле | Тип | Описание |
|------|------|----------|
| `id` | integer | Идентификатор операции. |
| `balance` | number | Баланс после выполнения операции (*Balance*). |
| `amount` | number | Сумма операции (*Amount*). |
| `currency` | string | Валюта операции (*Currency*). |
| `type` | string | Тип операции (*Operation Type*). |
| `timestamp` | integer | Время выполнения операции (Unix Timestamp, мс). |
| `commission` | number | Комиссия (*Commission*). |
| `paymentMethod` | string | Способ проведения операции (*Payment Method*). |
| `status` | string | Статус операции (*Operation Status*). |
| `blockchainTransactionHash` | string | Хэш транзакции в блокчейне (*Blockchain Transaction Hash*). |

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Требуется |
| API Key | Требуется |
| Подпись запроса | Требуется |
| Timestamp | Требуется |
| recvWindow | Поддерживается |
| Snapshot | Нет |
| Historical | Да |
| Stream | Нет |
| REST и WS Request эквивалентны | Да |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция возвращает историю операций вывода средств авторизованного пользователя.
- Ответ представляет собой массив однотипных объектов.
- Состав полей соответствует официальной документации Dzengi и может быть уточнён после проверки фактических ответов API.

---

## Infrastructure Operations

**Назначение**

Содержит служебные операции API, необходимые для обслуживания соединения и проверки доступности интерфейсов Dzengi.

**Использование**

Данные раздела могут использоваться последующими документами Dzentra для проектирования инфраструктурной части API-клиента.

---

### ping

#### Назначение

Проверка доступности WebSocket-соединения.

#### Результат операции

Возвращает служебный ответ, подтверждающий доступность соединения.

#### Режим получения данных

**Snapshot**

#### Доступные вызовы

| Способ | Путь |
|--------|------|
| WS Service | `ping` |

#### Версии API

| Версия | Поддержка |
|---------|-----------|
| WebSocket API | Да |

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

Отсутствуют.

#### Payload

*Структура определяется документацией Dzengi.*

#### Структура Payload

*Структура определяется документацией Dzengi.*

#### Характеристики операции

| Свойство | Значение |
|----------|----------|
| Авторизация | Не требуется |
| API Key | Не требуется |
| Подпись запроса | Не требуется |
| Timestamp | Не требуется |
| recvWindow | Не поддерживается |
| Snapshot | Да |
| Historical | Нет |
| Stream | Нет |
| REST и WS Request эквивалентны | Нет |

#### Использование в Dzentra

> **Не определяется настоящим документом.**

#### Примечания

- Операция относится к служебным операциям WebSocket API.
- Операция не является WebSocket Stream.
- Структура ответа требует проверки по документации или фактическому ответу API.