WebSocket API v1 Торговля - addOrder и cancelOrder

Последнее обновление: 1 апреля 2025 г.
  • •

    Размещение ордеров - addOrder

  • •

    Отмена ордеров - cancelOrder

Торговля (размещение и отмена ордеров) через WebSocket API v1 осуществляется с помощью addOrder и cancelOrder конечных точек. Подобно торговле через REST API, конечная точка addOrder используется для размещения новых ордеров, а конечная точка cancelOrder — для отмены существующих (открытых) ордеров.

После того как соединение с WebSocket API установлено, ордера можно размещать и отменять, выполнив следующие шаги:

  1. 1

    получите токен аутентификации через конечную точку REST API GetWebSocketsToken (после получения действительного токена тот же токен можно использовать для нескольких запросов addOrder/cancelOrder),

  2. 2

    отправьте соответствующий запрос addOrder/cancelOrder,

  3. 3

    получите ответ, указывающий, был ли запрос успешным.

Размещение ордеров - addOrder

Наша документация по WebSocket API содержит полную спецификацию конечной точки addOrder, включая формат JSON, который необходимо использовать, а также описания каждого обязательного и необязательного поля.

Например, следующее сообщение JSON разместит новый ордер на покупку 0,25 ETH/EUR по лимитной цене 150 евро:

{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}

Предполагая, что вышеуказанный ордер был успешно размещен (достаточно средств на балансе счета и т. д.), в ответ будет получено следующее сообщение JSON:

{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

Отмена ордеров - cancelOrder

Наша документация по WebSocket API содержит полную спецификацию конечной точки cancelOrder, включая формат JSON, который необходимо использовать, а также описания каждого обязательного и необязательного поля.

В отличие от REST API, конечная точка WebSocket API cancelOrder может использоваться для одновременной отмены нескольких ордеров путем указания каждого идентификатора ордера (или ссылки пользователя) в массиве txid.

Например, следующее сообщение JSON отменит любой открытый ордер с соответствующими идентификаторами ордеров:

{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}

Предполагая, что ордера были успешно отменены, в ответ будет получено следующее сообщение JSON:

{
"event": "cancelOrderStatus",
"status": "ok"
}

Нужна дополнительная помощь?