WebSocket API v1 Trading - addOrder a cancelOrder

Naposledy aktualizováno: 1. dubna 2025
  • •

    Zadávání objednávek - addOrder

  • •

    Rušení objednávek - cancelOrder

Obchodování (zadávání a rušení objednávek) prostřednictvím WebSocket API v1 je zajištěno pomocí addOrder a cancelOrder koncových bodů. Podobně jako obchodování prostřednictvím REST API, se koncový bod addOrder používá k zadávání nových objednávek a koncový bod cancelOrder se používá k rušení stávajících (otevřených) objednávek.

Jakmile je navázáno připojení k WebSocket API, objednávky lze zadávat a rušit pomocí následujících kroků:

  1. 1

    získat ověřovací token prostřednictvím koncového bodu REST API GetWebSocketsToken (jakmile je platný token získán, stejný token lze použít pro více požadavků addOrder/cancelOrder),

  2. 2

    odeslat příslušný požadavek addOrder/cancelOrder,

  3. 3

    obdržet odpověď, která indikuje, zda byl požadavek úspěšný či nikoli.

Zadávání objednávek - addOrder

Naše dokumentace WebSocket API poskytuje kompletní specifikaci pro koncový bod addOrder, včetně formátu JSON, který musí být použit, spolu s popisy každého povinného a volitelného pole.

Jako příklad, následující zpráva JSON by zadala novou objednávku na nákup 0,25 ETH/EUR za limitní cenu 150 €:

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

Za předpokladu, že výše uvedená objednávka byla úspěšně zadána (dostatečné prostředky dostupné na zůstatku účtu atd.), bude v odpovědi přijata následující zpráva JSON:

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

Rušení objednávek - cancelOrder

Naše dokumentace WebSocket API poskytuje kompletní specifikaci pro koncový bod cancelOrder, včetně formátu JSON, který musí být použit, spolu s popisy každého povinného a volitelného pole.

Na rozdíl od REST API lze koncový bod WebSocket API cancelOrder použít k zrušení více objednávek současně, a to zadáním každého ID objednávky (nebo uživatelské reference) v poli txid.

Jako příklad, následující zpráva JSON by zrušila jakoukoli otevřenou objednávku s odpovídajícími ID objednávek:

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

Za předpokladu, že objednávky byly úspěšně zrušeny, bude v odpovědi přijata následující zpráva JSON:

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

Potřebujete další pomoc?