Handel za pośrednictwem WebSocket API v1 - addOrder i cancelOrder

Ostatnia aktualizacja: 1 kwietnia 2025
  • •

    Składanie zleceń - addOrder

  • •

    Anulowanie zleceń - cancelOrder

Handel (składanie i anulowanie zleceń) za pośrednictwem WebSocket API v1 jest realizowany przez addOrder i cancelOrder punkty końcowe. Podobnie jak handel za pośrednictwem REST API, punkt końcowy addOrder służy do składania nowych zleceń, a punkt końcowy cancelOrder służy do anulowania istniejących (otwartych) zleceń.

Po nawiązaniu połączenia z WebSocket API zlecenia można składać i anulować, wykonując następujące kroki:

  1. 1

    pobierz token uwierzytelniający za pośrednictwem punktu końcowego REST API GetWebSocketsToken (po pobraniu ważnego tokena, ten sam token może być używany do wielu żądań addOrder/cancelOrder),

  2. 2

    wyślij odpowiednie żądanie addOrder/cancelOrder,

  3. 3

    otrzymaj odpowiedź wskazującą, czy żądanie zakończyło się sukcesem, czy nie.

Składanie zleceń - addOrder

Nasza dokumentacja WebSocket API zawiera kompletną specyfikację punktu końcowego addOrder, w tym format JSON, który musi być użyty, wraz z opisami każdego wymaganego i opcjonalnego pola.

Na przykład, poniższa wiadomość JSON złożyłaby nowe zlecenie kupna 0,25 ETH/EUR po cenie limitowanej 150 €:

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

Zakładając, że powyższe zlecenie zostało złożone pomyślnie (wystarczające środki dostępne na saldzie konta itp.), w odpowiedzi zostanie odebrana następująca wiadomość JSON:

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

Anulowanie zleceń - cancelOrder

Nasza dokumentacja WebSocket API zawiera kompletną specyfikację punktu końcowego cancelOrder, w tym format JSON, który musi być użyty, wraz z opisami każdego wymaganego i opcjonalnego pola.

W przeciwieństwie do REST API, punkt końcowy WebSocket API cancelOrder może być użyty do jednoczesnego anulowania wielu zleceń, poprzez określenie każdego identyfikatora zlecenia (lub referencji użytkownika) w tablicy txid.

Na przykład, poniższa wiadomość JSON anulowałaby każde otwarte zlecenie z pasującymi identyfikatorami zleceń:

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

Zakładając, że zlecenia zostały pomyślnie anulowane, w odpowiedzi zostanie odebrana następująca wiadomość JSON:

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

Potrzebujesz więcej pomocy?