API Bitget

Bitget

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...

Właściwości

Użyj właściwości BitgetChannel, aby wybrać typ kanału:

• bgcSpot: połącz się ze Spot WebSocket API.
• bgcFutures: połącz z API WebSocket Futures.

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

• ApiKey: nowy klucz API można wygenerować na koncie Bitget, a jego wartość należy skopiować do tej właściwości. Jeśli APIKey jest ustawiony, klient połączy się z prywatnym serwerem websocket. Jeśli jest pusty, połączy się z publicznym serwerem WebSocket.
• ApiSecret: to tajny klucz API.
• Passphrase: niestandardowy ciąg znaków zdefiniowany podczas tworzenia nowego klucza API.
• Resubscribe: jeśli włączone, po ponownym połączeniu klient automatycznie ponownie subskrybuje kanały, które były aktywne przed rozłączeniem (domyślnie false).

Połączenie

Gdy klient pomyślnie połączy się z serwerami Bitget, wywoływane jest zdarzenie OnConnect. Po wywołaniu zdarzenia OnConnect można rozpocząć wysyłanie i odbieranie wiadomości do i z serwerów Bitget. Jeśli nawiązywane jest połączenie z prywatnym kanałem websocket, należy poczekać na wywołanie zdarzenia OnBitgetAuthentication i sprawdzić, czy parametr success ma wartość true, zanim nastąpi subskrypcja jakiegokolwiek kanału.

oClient := TsgcWebSocketClient.Create(nil);
oBitget := TsgcWS_API_Bitget.Create(nil);
oBitget.Client := oClient;
oBitget.Bitget.ApiKey := 'your_api_key';
oBitget.Bitget.ApiSecret := 'your_api_secret';
oBitget.Bitget.Passphrase := 'your_passphrase';
oBitget.BitgetChannel := bgcSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#Bitget Connected');
end;

Zdarzenia

Klient Bitget implementuje następujące zdarzenia do kontrolowania przepływu połączenia i odbierania danych wysłanych z serwera WebSocket:

• OnConnect: wywoływane, gdy klient websocket łączy się z serwerem WebSocket.
• OnDisconnect: wywoływane, gdy klient WebSocket rozłącza się z serwerem WebSocket.
• OnBitgetAuthentication: wywoływane, gdy klient uwierzytelnia się na prywatnym serwerze WebSocket.
• OnBitgetSubscribe: gdy klient subskrybuje kanał websocket.
• OnBitgetUnSubscribe: wywoływane, gdy klient anuluje subskrypcję kanału websocket.
• OnBitgetData: wywoływane, gdy klient odbiera dane z serwera.
• OnBitgetError: wywoływane w przypadku wystąpienia błędu podczas połączenia WebSocket z serwisem Bitget.
• OnBitgetHTTPException: wywoływane w przypadku błędu podczas żądania REST.

WebSocket API

Kanał WebSocket dostarcza aktualizacje rynku w czasie rzeczywistym dotyczące zleceń i transakcji.

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

Metoda	Publiczny lub prywatny	Opis
SubscribeTicker	Publiczny	Subskrybuj strumień tickera dla instrumentu.
SubscribeTrade	Publiczny	Subskrybuj strumień ostatnich transakcji.
SubscribeCandle	Publiczny	Subskrybuje strumień wykresów świecowych. Obsługuje wiele interwałów (np. candle1m, candle5m, candle1H).
SubscribeOrderBook	Publiczny	Subskrybuj strumień arkusza zleceń. Obsługuje różne poziomy głębokości.
SubscribeOrders	Prywatny	Subskrypcja aktualizacji zleceń. Wymaga uwierzytelnienia.
SubscribePositions	Prywatny	Subskrybuj aktualizacje pozycji. Wymaga uwierzytelnienia.
SubscribeAccount	Prywatny	Subskrybuj aktualizacje salda konta. Wymagane uwierzytelnianie.

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

procedure OnBitgetAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string);
begin
  if aSuccess then
  begin
    oBitget.SubscribeOrders('BTCUSDT');
    oBitget.SubscribeAccount();
  end;
end;

REST API

REST API udostępnia publiczne i prywatne metody do żądania danych z rynków i prywatnych kont. Dostęp do REST API uzyskuje się przez właściwość REST_API komponentu.

Metoda	Publiczny / Prywatny	Opis
GetServerTime	Publiczny	Pobierz czas serwera.
GetTickers	Publiczny	Pobiera informacje o tickerze dla jednego lub wszystkich symboli.
GetOrderBook	Publiczny	Pobierz arkusz zleceń dla symbolu.
GetCandles	Publiczny	Pobierz dane świec/kline dla symbolu.
GetRecentTrades	Publiczny	Pobierz najnowsze transakcje dla danego symbolu.
PlaceOrder	Prywatny	Złóż nowe zamówienie.
CancelOrder	Prywatny	Anuluje istniejące zlecenie.
GetOpenOrders	Prywatny	Pobiera listę otwartych zleceń.
GetOrderDetail	Prywatny	Pobierz szczegóły określonego zlecenia.
GetOrderHistory	Prywatny	Pobierz historię zleceń.
GetAccountAssets	Prywatny	Pobierz informacje o aktywach konta.
GetAccountInfo	Prywatny	Pobierz informacje o koncie.

Poniżej znajduje się przykład użycia REST API.

oBitget := TsgcWS_API_Bitget.Create(nil);
oBitget.Bitget.ApiKey := 'your_api_key';
oBitget.Bitget.ApiSecret := 'your_api_secret';
oBitget.Bitget.Passphrase := 'your_passphrase';
// Get tickers
oBitget.REST_API.GetTickers('SPOT');
// Place an order
oBitget.REST_API.PlaceOrder('BTCUSDT', 'buy', 'market', 'normal', '0.01');