API OKX

OKX

Obsługiwane API

• WebSockets API: łączy się z serwerem WebSocket i dostarcza aktualizacje danych rynkowych w czasie rzeczywistym, zmiany na koncie oraz umożliwia składanie zleceń handlowych.

Właściwości

Kanały WebSocket są podzielone na dwie kategorie: publiczne i prywatne.

• Kanały publiczne: obejmują kanał tickerów, kanał K-Line, kanał ceny limitowej, kanał księgi zleceń oraz kanał ceny mark itp. — nie wymagają logowania.
• Kanały prywatne: w tym kanał konta, kanał zleceń i kanał pozycji itd. — wymagają zalogowania.

W właściwości OKX można skonfigurować następujące właściwości.

• ApiKey: nowy klucz API można wygenerować na koncie OKX; należy skopiować jego wartość do tej właściwości.
• ApiSecret: to tajny klucz API.
• Passphrase: niestandardowy ciąg znaków zdefiniowany podczas tworzenia nowego klucza API.

• IsDemo: po włączeniu następuje połączenie z kontem demonstracyjnym OKX (domyślnie wyłączone).
• IsPrivate: jeśli jest włączone, możliwe jest połączenie z kanałami prywatnymi (domyślnie wyłączone).
• IsBusiness: jeśli włączone, komponent połączy się z biznesowym endpointem WebSocket (wss://ws.okx.com:8443/ws/v5/business). Należy używać dla kanałów świecowych, kanałów zleceń algorytmicznych i innych zaawansowanych kanałów (domyślnie wyłączone).

Połączenie

Gdy klient pomyślnie połączy się z serwerami OKX, wywoływane jest zdarzenie OnOKXConnect . Jeśli wystąpi błąd podczas próby połączenia, zdarzenie OnOKXError zostanie wywołane ze szczegółami błędu.

Po wywołaniu zdarzenia OnOKXConnect można rozpocząć wysyłanie i odbieranie wiadomości z serwerów OKX.

oClient := TsgcWebSocketClient.Create(nil);
oOKX := TsgcWSAPI_OKX.Create(nil);
oOKX.Client := oClient;
oOKX.OKX.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oOKX.OKX.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oOKX.OKX.Passphrase := 'secret_passphrase';
oClient.Active := True;
procedure OnOKXConnect(Sender: TObject; aMessage, aCode, aRawMessage: string);
begin
  DoLog('#OKX Connected');
end;
procedure OnOKXError(Sender: TObject; aCode, aMessage, aRawMessage: string);
begin
  DoLog('#error: ' + aMessage);
end;

Kanały publiczne

Kanał WebSocket dostarcza aktualizacje rynkowe w czasie rzeczywistym dla zleceń i transakcji. Kanał WebSocket posiada publiczne kanały takie jak ticker, trades...

Możliwa jest subskrypcja następujących kanałów publicznych:

oClient := TsgcWebSocketClient.Create(nil);
oOKX := TsgcWSAPI_OKX.Create(nil);
oOKX.Client := oClient;
oOKX.OKX.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oOKX.OKX.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oOKX.OKX.Passphrase := 'secret_passphrase';
oClient.Active := True;
procedure OnOKXConnect(Sender: TObject; aMessage, aCode, aRawMessage: string);
begin
  oOKX.SubscribeInstruments(okxitFutures);
end;

Kanały prywatne

Kanały wymagające logowania: kanał konta, kanał zleceń, kanał pozycji i inne.

Można subskrybować następujące kanały prywatne:

oClient := TsgcWebSocketClient.Create(nil);
oOKX := TsgcWSAPI_OKX.Create(nil);
oOKX.Client := oClient;
oOKX.OKX.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oOKX.OKX.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oOKX.OKX.Passphrase := 'secret_passphrase';
oClient.Active := True;
procedure OnOKXConnect(Sender: TObject; aMessage, aCode, aRawMessage: string);
begin
  oOKX.SubscribeOrders(okxitFutures, 'BTC-USD', 'BTC-USD-200329');
end;

Handel

WebSocket Trade wymaga uwierzytelniania.

Zlecenie można złożyć tylko w przypadku posiadania wystarczających środków. Poniżej znajduje się tabela z parametrami żądania:

Przykład złożenia zlecenia

Zlecenie można złożyć tylko wtedy, gdy dostępne są wystarczające środki.

// Place Martket Order
TsgcWSAPI_OKX1.PlaceMarketOrder(okxosBuy, 'ETH-BTC', 1);
// Place Limit Order
TsgcWSAPI_OKX1.PlaceLimitOrder(okxosBuy, 'ETH-BTC', 1, 0.25);

Przykład anulowania zlecenia

Anuluj niekompletne zlecenie

TsgcWSAPI_OKX1.CancelOrder('ETH-BTC', '457589362405027840');

Zmiana zlecenia

Zmień niekompletne zlecenie.

TsgcWSAPI_OKX1.AmendOrder('ETH-BTC', '457589362405027840', '', 2);

Wsadowe operacje handlowe

WebSocket Trade API obsługuje również operacje wsadowe umożliwiające jednoczesne składanie, anulowanie i modyfikowanie wielu zleceń. Operacje te wymagają uwierzytelnienia.