Торгівля через 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 можна використовувати для одночасного скасування кількох ордерів, вказавши кожен ID ордера (або посилання користувача) у масиві txid.

Як приклад, наступне повідомлення JSON скасує будь-який відкритий ордер із відповідними ID ордерів:

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

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

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

Потрібна додаткова допомога?