Tranzacționare API WebSocket v1 - addOrder și cancelOrder

Ultima actualizare: 1 aprilie 2025
  • Plasarea ordinelor - addOrder

  • Anularea ordinelor - cancelOrder

Tranzacționarea (plasarea și anularea ordinelor) prin intermediul API-ului WebSocket v1 este asigurată de endpoint-urile addOrder și cancelOrder. Similar cu tranzacționarea prin intermediul API-ului REST, endpoint-ul addOrder este utilizat pentru a plasa ordine noi, iar endpoint-ul cancelOrder este utilizat pentru a anula ordinele existente (deschise).

Odată ce o conexiune la API-ul WebSocket a fost stabilită, ordinele pot fi plasate și anulate prin următorii pași:

  1. 1

    recuperezi un token de autentificare prin intermediul endpoint-ului REST API GetWebSocketsToken (odată ce un token valid a fost recuperat, același token poate fi utilizat pentru multiple solicitări addOrder/cancelOrder),

  2. 2

    trimite solicitarea addOrder/cancelOrder corespunzătoare,

  3. 3

    primești un răspuns care indică dacă solicitarea a fost sau nu reușită.

Plasarea ordinelor - addOrder

Documentația noastră API WebSocket oferă specificația completă pentru endpoint-ul addOrder, inclusiv formatul JSON care trebuie utilizat, împreună cu descrierile fiecărui câmp obligatoriu și opțional.

De exemplu, următorul mesaj JSON ar plasa un ordin nou pentru a cumpăra 0,25 ETH/EUR la un preț limită de 150 €:

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

Presupunând că ordinul de mai sus a fost plasat cu succes (fonduri suficiente disponibile în soldul contului etc.), următorul mesaj JSON ar fi primit ca răspuns:

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

Anularea ordinelor - cancelOrder

Documentația noastră API WebSocket oferă specificația completă pentru endpoint-ul cancelOrder, inclusiv formatul JSON care trebuie utilizat, împreună cu descrierile fiecărui câmp obligatoriu și opțional.

Spre deosebire de API-ul REST, endpoint-ul cancelOrder al API-ului WebSocket poate fi utilizat pentru a anula mai multe ordine simultan, specificând fiecare ID de ordin (sau referință de utilizator) în array-ul txid.

De exemplu, următorul mesaj JSON ar anula orice ordin deschis cu ID-urile de ordin corespunzătoare:

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

Presupunând că ordinele au fost anulate cu succes, următorul mesaj JSON ar fi primit ca răspuns:

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

Ai nevoie de mai mult ajutor?