Приватные каналы

Каналы для получения информации о счёте, ордерах и позициях пользователя.

Важно: Для доступа к приватным каналам требуется авторизация. После подключения отправьте JWT токен первым сообщением.

ACCOUNT@my-balances

Балансы счёта пользователя в реальном времени.

Замените ACCOUNT на тип счёта.

Типы счетов:

Код	Описание
CLNTF	Торговый счёт
HLORD	Счёт холдирования (заблокированные средства)

Подписка:

JSON

{"method":"subscribe","data":["CLNTF@my-balances"]}

JSON

{"method":"subscribe","data":["HLORD@my-balances"]}

Ответ:

JSON

{
  "data": {
    "currency": "USDT",
    "available": "1500.50",
    "held": "200.00"
  },
  "stream": "CLNTF@my-balances"
}

Поля:

Поле	Тип	Описание
currency	string	Валюта
available	string	Доступный баланс
held	string	Заблокированный баланс

---

SYMBOL@order-info

Информация об активных ордерах по инструменту.

Замените SYMBOL на код инструмента.

Подписка:

JSON

{"method":"subscribe","data":["USDTRUB@order-info"]}

JSON

{"method":"subscribe","data":["BTCUSDTFUT@order-info"]}

Ответ:

JSON

{
  "data": {
    "orderId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "symbol": "USDTRUB",
    "side": "buy",
    "type": "limit",
    "price": "78.00",
    "qty": "1000",
    "filledQty": "500",
    "status": "partially_filled",
    "createdAt": "2026-01-20T10:00:00.000Z",
    "updatedAt": "2026-01-20T10:05:00.000Z"
  },
  "stream": "USDTRUB@order-info"
}

Поля:

Поле	Тип	Описание
orderId	string	Уникальный ID ордера
symbol	string	Символ инструмента
side	string	Сторона: buy / sell
type	string	Тип: limit / market
price	string	Цена ордера
qty	string	Объём ордера
filledQty	string	Исполненный объём
status	string	Статус ордера
createdAt	string	Время создания
updatedAt	string	Время обновления

Статусы ордеров:

Статус	Описание
new	Новый ордер
partially_filled	Частично исполнен
filled	Полностью исполнен
canceled	Отменён
rejected	Отклонён

---

SYMBOL@order-history

История ордеров по инструменту.

Замените SYMBOL на код инструмента.

Подписка:

JSON

{"method":"subscribe","data":["USDTRUB@order-history"]}

JSON

{"method":"subscribe","data":["BTCUSDTFUT@order-history"]}

Ответ: аналогичен SYMBOL@order-info.

---

SYMBOL@my-trades

Сделки пользователя по инструменту.

Замените SYMBOL на код инструмента.

Подписка:

JSON

{"method":"subscribe","data":["USDTRUB@my-trades"]}

JSON

{"method":"subscribe","data":["BTCUSDTFUT@my-trades"]}

Ответ:

JSON

{
  "data": {
    "tradeId": "t1234567-89ab-cdef-0123-456789abcdef",
    "orderId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "symbol": "USDTRUB",
    "side": "buy",
    "price": "78.50",
    "qty": "500",
    "fee": "0.25",
    "feeCurrency": "RUB",
    "createdAt": "2026-01-20T10:05:00.000Z"
  },
  "stream": "USDTRUB@my-trades"
}

Поля:

Поле	Тип	Описание
tradeId	string	ID сделки
orderId	string	ID ордера
symbol	string	Символ инструмента
side	string	Сторона: buy / sell
price	string	Цена сделки
qty	string	Объём сделки
fee	string	Комиссия
feeCurrency	string	Валюта комиссии
createdAt	string	Время сделки

---

position-info

Информация о фьючерсных позициях.

Подписка:

JSON

{"method":"subscribe","data":["position-info"]}

Ответ:

JSON

{
  "data": {
    "positionId": "0fe1c42e-496c-5a93-9428-e212447e3b6b",
    "instrumentCode": "BTCUSDTFUT",
    "instrumentId": "6eba6ac0-2611-47d9-8e0a-5fe12dad382e",
    "side": "long",
    "qty": "0.005",
    "avgEntryPrice": "94746.1",
    "markPrice": "91266.8",
    "liqPrice": "61150",
    "leverage": "3",
    "marginType": "cross",
    "unrealizedPnl": "-17.3965",
    "realizedPnl": "0",
    "realizedTotalPnl": "-0.17084094",
    "initialMargin": "157.9101666666666667",
    "maintenanceMargin": "23.686525",
    "maintenanceMarginRate": "0.05",
    "effectivePositionValue": "456.334",
    "fundingFeeTotal": "-0.04917799",
    "openTradingFeeTotal": "0.12166295",
    "closeTradingFeeTotal": "0",
    "stopLoss": "0",
    "takeProfit": "0",
    "status": "open",
    "adlPriority": 2,
    "autoMarginEnabled": false,
    "reduceOnlyMode": false,
    "positionIdx": "one-way",
    "riskLimitTier": 1,
    "createdAt": "2026-01-15T12:13:51.909712+03:00",
    "updatedAt": "2026-01-20T11:03:31.382140081Z",
    "closedAt": null,
    "userId": "87223898-214a-48cf-b83f-d9efea88a19b"
  },
  "stream": "position-info"
}

Основные поля:

Поле	Тип	Описание
positionId	string	ID позиции
instrumentCode	string	Код инструмента
side	string	Направление: long / short
qty	string	Размер позиции
avgEntryPrice	string	Средняя цена входа
markPrice	string	Цена маркировки
liqPrice	string	Цена ликвидации
leverage	string	Кредитное плечо
marginType	string	Тип маржи: cross / isolated
unrealizedPnl	string	Нереализованный PnL
realizedPnl	string	Реализованный PnL
initialMargin	string	Начальная маржа
maintenanceMargin	string	Поддерживающая маржа
stopLoss	string	Стоп-лосс (0 = не установлен)
takeProfit	string	Тейк-профит (0 = не установлен)
status	string	Статус: open / closed
adlPriority	integer	Приоритет ADL (1-5)

---

pending-order-info

Информация об отложенных (условных) ордерах.

Подписка:

JSON

{"method":"subscribe","data":["pending-order-info"]}

Ответ:

JSON

{
  "data": {
    "orderId": "p1234567-89ab-cdef-0123-456789abcdef",
    "symbol": "BTCUSDTFUT",
    "side": "sell",
    "type": "stop_market",
    "triggerPrice": "90000",
    "qty": "0.005",
    "status": "pending",
    "createdAt": "2026-01-20T10:00:00.000Z"
  },
  "stream": "pending-order-info"
}

Поля:

Поле	Тип	Описание
orderId	string	ID ордера
symbol	string	Символ инструмента
side	string	Сторона: buy / sell
type	string	Тип: stop_market / stop_limit / take_profit / take_profit_limit
triggerPrice	string	Цена срабатывания
qty	string	Объём
status	string	Статус
createdAt	string	Время создания

---

portfolio-metrics

Метрики портфеля — сводная информация о марже и балансе.

Подписка:

JSON

{"method":"subscribe","data":["portfolio-metrics"]}

Ответ:

JSON

{
  "data": {
    "userId": "87223898-214a-48cf-b83f-d9efea88a19b",
    "availableBalance": "16.35990692",
    "marginBalance": "174.27007359",
    "initialMarginBalance": "157.91016667",
    "maintenanceMarginBalance": "23.686525",
    "imRatio": "0.9062",
    "mmRatio": "0.136"
  },
  "stream": "portfolio-metrics"
}

Поля:

Поле	Тип	Описание
userId	string	ID пользователя
availableBalance	string	Доступный баланс для торговли
marginBalance	string	Общий баланс маржи
initialMarginBalance	string	Использованная начальная маржа
maintenanceMarginBalance	string	Поддерживающая маржа
imRatio	string	Коэффициент начальной маржи (IM / Equity)
mmRatio	string	Коэффициент поддерживающей маржи (MM / Equity)

Предупреждение: Если mmRatio приближается к 1.0, позиции могут быть ликвидированы.