Активные ордеры
Обновления активных ордеров в режиме реального времени. Требуется аутентификация.
Внимание
Это приватный канал. Вы должны аутентифицировать WebSocket-соединение перед подпиской. Подробности об аутентификации см. в обзоре WebSocket.
Запрос на подписку:
{
"id": "12345",
"method": "subscribe",
"params": {
"channel": "activeOrders"
}
}
Ответы
Ответ на подписку:
{
"id": "12345",
"result": {
"success": true
}
}
Лимитный ордер
Пример потока данных (Обновление лимитного ордера):
{
"method": "subscription",
"params": {
"channel": "activeOrders",
"data": {
"orders": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"clientOrderId": "928a68bc-d67c-465a-9d65-5c58c8bb8970",
"symbol": "BTC-USDT",
"side": "buy",
"type": "limit",
"status": "working",
"createdAt": "2024-12-05T12:51:20.917Z",
"updatedAt": "2024-12-05T12:51:20.917Z",
"dealSize": "0.1",
"dealFunds": "5000.0",
"fee": "1.82",
"feeAsset": "USDT",
"remark": "string",
"timeInForce": "GTC",
"size": "1.0",
"funds": "50000.0",
"price": "50000.0"
}
]
}
}
}
Параметры ответа лимитного ордера
| Параметр | Описание |
|---|---|
| id (обязательный) | Уникальный идентификатор ордера. Тип: string. |
| clientOrderId (optional) | Клиентский идентификатор ордера. Тип: string. |
| symbol (обязательный) | Торговая пара. Тип: string. |
| side (обязательный) | Сторона ордера. Доступные значения: buy, sell. |
| type (обязательный) | Для лимитного ордера: limit. Доступные значения: limit, market, stopMarket, stopLimit. |
| status (обязательный) | Статус ордера. Доступные значения: working, rejected, cancelled, completed, expired, pending, sending. |
| createdAt (обязательный) | Временная метка создания ордера. Тип: string. |
| updatedAt (обязательный) | Временная метка обновления ордера. Тип: string. |
| dealSize (обязательный) | Исполненный объём в базовой валюте. Тип: string. |
| dealFunds (обязательный) | Накопленная сумма котируемой валюты, которая уже была потрачена или получена. Тип: string. |
| fee (обязательный) | Сумма комиссии. Тип: string. |
| feeAsset (обязательный) | Актив комиссии. Тип: string. |
| remark (optional) | Тип: string. |
| timeInForce (обязательный) | Параметр срока действия ордера (Time In Force). Доступные значения: GTC, IOC, FOK. |
| size (обязательный) | Общий размер или сумма ордера в базовой валюте (сумма, предназначенная для покупки/продажи). Тип: string. |
| funds (обязательный) | Общая сумма средств или сумма котируемой валюты, задействованной в ордере. Тип: string. |
| price (обязательный) | Цена, по которой актив торгуется или предлагается в котируемой валюте. Тип: string. |
Рыночный ордер
Пример потока данных (Обновление рыночного ордера):
{
"method": "subscription",
"params": {
"channel": "activeOrders",
"data": {
"orders": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"clientOrderId": "928a68bc-d67c-465a-9d65-5c58c8bb8970",
"symbol": "BTC-USDT",
"side": "buy",
"type": "market",
"status": "working",
"createdAt": "2024-12-05T12:51:20.917Z",
"updatedAt": "2024-12-05T12:51:20.917Z",
"dealSize": "0.1",
"dealFunds": "5000.0",
"fee": "1.82",
"feeAsset": "USDT",
"remark": "string",
"timeInForce": "GTC",
"size": "1.0",
"funds": "50000.0"
}
]
}
}
}
Параметры ответа рыночного ордера
| Параметр | Описание |
|---|---|
| id (обязательный) | Уникальный идентификатор ордера. Тип: string. |
| clientOrderId (optional) | Клиентский идентификатор ордера. Тип: string. |
| symbol (обязательный) | Торговая пара. Тип: string. |
| side (обязательный) | Сторона ордера. Доступные значения: buy, sell. |
| type (обязательный) | Для рыночного ордера: market. Доступные значения: limit, market, stopMarket, stopLimit. |
| status (обязательный) | Статус ордера. Доступные значения: working, rejected, cancelled, completed, expired, pending, sending. |
| createdAt (обязательный) | Временная метка создания ордера. Тип: string. |
| updatedAt (обязательный) | Временная метка обновления ордера. Тип: string. |
| dealSize (обязательный) | Исполненный объём в базовой валюте. Тип: string. |
| dealFunds (обязательный) | Накопленная сумма котируемой валюты, которая уже была потрачена или получена. Тип: string. |
| fee (обязательный) | Сумма комиссии. Тип: string. |
| feeAsset (обязательный) | Актив комиссии. Тип: string. |
| remark (optional) | Тип: string. |
| timeInForce (обязательный) | Параметр срока действия ордера (Time In Force). Доступные значения: GTC, IOC, FOK. |
| size (optional) | Общий размер или сумма ордера в базовой валюте (сумма, предназначенная для покупки/продажи). Тип: string. |
| funds (optional) | Общая сумма средств или сумма котируемой валюты, задействованной в ордере. Тип: string. |
Стоп-маркет-ордер
Пример потока данных (Обновление стоп-маркет-ордера):
{
"method": "subscription",
"params": {
"channel": "activeOrders",
"data": {
"orders": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"clientOrderId": "928a68bc-d67c-465a-9d65-5c58c8bb8970",
"symbol": "BTC-USDT",
"side": "sell",
"type": "stopMarket",
"status": "working",
"createdAt": "2024-12-05T12:51:20.917Z",
"updatedAt": "2024-12-05T12:51:20.917Z",
"dealSize": "0.0",
"dealFunds": "0.0",
"fee": "0.0",
"feeAsset": "USDT",
"remark": "string",
"timeInForce": "IOC",
"size": "1.0",
"stopTriggered": false,
"stopPrice": "46000.0"
}
]
}
}
}
Параметры ответа стоп-маркет-ордера
| Параметр | Описание |
|---|---|
| id (обязательный) | Уникальный идентификатор ордера. Тип: string. |
| clientOrderId (optional) | Клиентский идентификатор ордера. Тип: string. |
| symbol (обязательный) | Торговая пара. Тип: string. |
| side (обязательный) | Сторона ордера. Доступные значения: buy, sell. |
| type (обязательный) | Для стоп-маркет-ордера: stopMarket. Доступные значения: limit, market, stopMarket, stopLimit. |
| status (обязательный) | Статус ордера. Доступные значения: working, rejected, cancelled, completed, expired, pending, sending. |
| createdAt (обязательный) | Временная метка создания ордера. Тип: string. |
| updatedAt (обязательный) | Временная метка обновления ордера. Тип: string. |
| dealSize (обязательный) | Исполненный объём в базовой валюте. Тип: string. |
| dealFunds (обязательный) | Накопленная сумма котируемой валюты, которая уже была потрачена или получена. Тип: string. |
| fee (обязательный) | Сумма комиссии. Тип: string. |
| feeAsset (обязательный) | Актив комиссии. Тип: string. |
| remark (optional) | Тип: string. |
| timeInForce (обязательный) | Параметр срока действия ордера (Time In Force). Доступные значения: GTC, IOC, FOK. |
| size (обязательный) | Общий размер или сумма ордера в базовой валюте (сумма, предназначенная для покупки/продажи). Тип: string. |
| stopTriggered (обязательный) | Указывает, была ли достигнута стоп-цена и был ли активирован ордер. true — активирован, false — ожидает. Тип: boolean. |
| stopPrice (обязательный) | Цена, при достижении которой активируется стоп-ордер. Когда рыночная цена достигает этого уровня, ордер отправляется как рыночный или лимитный. Тип: string. |
Стоп-лимит-ордер
Пример потока данных (Обновление стоп-лимит-ордера):
{
"method": "subscription",
"params": {
"channel": "activeOrders",
"data": {
"orders": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"clientOrderId": "928a68bc-d67c-465a-9d65-5c58c8bb8970",
"symbol": "BTC-USDT",
"side": "sell",
"type": "stopLimit",
"status": "working",
"createdAt": "2024-12-05T12:51:20.917Z",
"updatedAt": "2024-12-05T12:51:20.917Z",
"dealSize": "0.0",
"dealFunds": "0.0",
"fee": "0.0",
"feeAsset": "USDT",
"remark": "string",
"timeInForce": "IOC",
"size": "1.0",
"funds": "50000.0",
"price": "50000.0",
"stopTriggered": false,
"stopPrice": "46000.0"
}
]
}
}
}
Параметры ответа стоп-лимит-ордера
| Параметр | Описание |
|---|---|
| id (обязательный) | Уникальный идентификатор ордера. Тип: string. |
| clientOrderId (optional) | Клиентский идентификатор ордера. Тип: string. |
| symbol (обязательный) | Торговая пара. Тип: string. |
| side (обязательный) | Сторона ордера. Доступные значения: buy, sell. |
| type (обязательный) | Для стоп-лимит-ордера: stopLimit. Доступные значения: limit, market, stopMarket, stopLimit. |
| status (обязательный) | Статус ордера. Доступные значения: working, rejected, cancelled, completed, expired, pending, sending. |
| createdAt (обязательный) | Временная метка создания ордера. Тип: string. |
| updatedAt (обязательный) | Временная метка обновления ордера. Тип: string. |
| dealSize (обязательный) | Исполненный объём в базовой валюте. Тип: string. |
| dealFunds (обязательный) | Накопленная сумма котируемой валюты, которая уже была потрачена или получена. Тип: string. |
| fee (обязательный) | Сумма комиссии. Тип: string. |
| feeAsset (обязательный) | Актив комиссии. Тип: string. |
| remark (optional) | Тип: string. |
| timeInForce (обязательный) | Параметр срока действия ордера (Time In Force). Доступные значения: GTC, IOC, FOK. |
| size (обязательный) | Общий размер или сумма ордера в базовой валюте (сумма, предназначенная для покупки/продажи). Тип: string. |
| funds (обязательный) | Общая сумма средств или сумма котируемой валюты, задействованной в ордере. Тип: string. |
| price (обязательный) | Цена, по которой актив торгуется или предлагается в котируемой валюте. Тип: string. |
| stopTriggered (обязательный) | Указывает, была ли достигнута стоп-цена и был ли активирован ордер. true — активирован, false — ожидает. Тип: boolean. |
| stopPrice (обязательный) | Цена, при достижении которой активируется стоп-ордер. Когда рыночная цена достигает этого уровня, ордер отправляется как рыночный или лимитный. Тип: string. |