API Bybit

Bybit

Obsługiwane API

• WebSocket API: łączy się z serwerem websocket i zapewnia aktualizacje danych rynkowych w czasie rzeczywistym, zmiany konta i inne informacje.
• REST API: wysyłanie żądań HTTP w celu pobierania danych rynkowych, składania zleceń, danych konta...

Aktualnie obsługiwana wersja API to V5. API V5 wprowadza jednolitość i wydajność dla linii produktów Bybit, łącząc Spot, Derivatives i Options w jeden zestaw specyfikacji.

*Uwaga: konto Unified obsługuje handel odwrócony. Jednak używany depozyt zabezpieczający pochodzi z portfela pochodnych odwróconych, a nie z portfela unified.

Właściwości

Następujące właściwości można skonfigurować we właściwości Bybit.

• ApiKey: klucz API można uzyskać na koncie Bybit. Należy skopiować jego wartość do tej właściwości. Jeśli APIKey jest ustawiony, klient połączy się z prywatnym serwerem WebSocket. Jeśli pole jest puste, klient połączy się z publicznym serwerem WebSocket.
• ApiSecret: to tajny klucz API.
• SignatureExpires: liczba sekund, po których podpis wygasa (domyślnie 10 sekund).

• TestNet: jeśli włączone, połączy się z kontem demonstracyjnym Bybit TestNet (domyślnie wyłączone).

Połączenie

Gdy klient pomyślnie połączy się z serwerami Bybit, wywoływane jest zdarzenie OnConnect. Po jego wywołaniu można rozpocząć wysyłanie i odbieranie wiadomości do/z serwerów Bybit. W przypadku łączenia się z prywatnym kanałem WebSocket należy poczekać na wywołanie zdarzenia OnBybitAuthentication i sprawdzić, czy parametr success ma wartość true, przed subskrypcją jakiegokolwiek kanału.

Klient obsługuje kilka API; właściwość BybitClient służy do określenia, które API ma być używane:

• bybSpot
• bybInverse
• bybLinear
• bybPerpetual

Poniżej znajduje się przykład połączenia z prywatnym WebSocket Spot API.

oClient := TsgcWebSocketClient.Create(nil);
oBybit := TsgcWSAPI_Bybit.Create(nil);
oBybit.Client := oClient;
oBybit.Bybit.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oBybit.Bybit.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oBybit.BybitClient := bybSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#Bybit Connected');
end;

Po pomyślnym połączeniu ze Spot WebSocket Server można rozpocząć subskrybowanie kanałów WebSocket. Wystarczy uzyskać dostęp do właściwości SPOT, a następnie wywołać dowolną z dostępnych metod subskrypcji/anulowania subskrypcji.

Zdarzenia

Klient bybit implementuje następujące zdarzenia do kontrolowania przepływu połączenia i odbierania danych wysyłanych przez serwer WebSocket:

• OnConnect: wywoływane, gdy klient websocket łączy się z serwerem WebSocket.
• OnDisconnect: wywoływane, gdy klient WebSocket rozłącza się z serwerem WebSocket.
• OnBybitAuthentication: wywoływane, gdy klient uwierzytelnia się na prywatnym serwerze WebSocket Bybit.
• OnBybitSubscribe: wywoływane, gdy klient subskrybuje kanał WebSocket.
• OnBybitUnSubscribe: wywoływane, gdy klient anuluje subskrypcję kanału websocket.
• OnBybitData: wywoływane, gdy klient otrzymuje dane z serwera.
• OnBybitError: gdy wystąpi błąd podczas połączenia websocket bybit.
• OnBybitHTTPException: wywoływane w przypadku wystąpienia błędu podczas żądania REST.

WebSocket API

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

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

Poniżej znajduje się przykład subskrybowania prywatnych kanałów WebSocket po pomyślnym uwierzytelnieniu.

oClient := TsgcWebSocketClient.Create(nil);
oBybit := TsgcWSAPI_Bybit.Create(nil);
oBybit.Client := oClient;
oBybit.Bybit.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oBybit.Bybit.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oBybit.BybitClient := bybSpot;
oClient.Active := True;
procedure OnBybitAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string)
begin
  if aSuccess then
  begin
    oClient.SubscribeOrderBook('BTCUSDT');
    oClient.SubscribeTrade('BTCUSDT');
  end;
end;

REST API

REST API zawiera listę publicznych i prywatnych metod do pobierania danych dotyczących rynków, prywatnego konta i portfela. Poniżej znajduje się lista dostępnych metod.

Poniżej znajduje się przykład pobierania otwartych zleceń.

oClient := TsgcWebSocketClient.Create(nil);
oBybit := TsgcWSAPI_Bybit.Create(nil);
oBybit.Client := oClient;
oBybit.Bybit.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oBybit.Bybit.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oBybit.BybitClient := bybSpot;
oBybit.REST_API.GetAccountInfo();