Перейти к основному содержимому

Активные ордеры

Обновления активных ордеров в режиме реального времени. Требуется аутентификация.

Внимание

Это приватный канал. Вы должны аутентифицировать 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.