API Bitget

Bitget

Ondersteunde API's

• WebSocket API: maak verbinding met een websocket-server en biedt realtime marktgegevensupdates, accountwijzigingen en meer.
• REST API: stuur HTTP-verzoeken om marktgegevens op te halen, orders te plaatsen, accountgegevens...

Eigenschappen

Gebruik de eigenschap BitgetChannel om het kanaaltype te selecteren:

• bgcSpot: verbinding maken met de Spot WebSocket API.
• bgcFutures: maak verbinding met de Futures WebSocket API.

U kunt de volgende eigenschappen configureren in de eigenschap Bitget.

• ApiKey: u kunt een nieuwe API-sleutel aanvragen in uw Bitget-account; kopieer de waarde naar deze eigenschap. Als de APIKey is ingesteld, maakt de client verbinding met de privé WebSocket-server. Als deze leeg is, wordt verbinding gemaakt met de openbare WebSocket-server.
• ApiSecret: het is de geheime waarde van de API.
• Passphrase: dit is de aangepaste tekenreeks die is gedefinieerd bij het aanmaken van een nieuwe API-sleutel.
• Resubscribe: indien ingeschakeld abonneert de client zich na een herverbinding automatisch opnieuw op de kanalen die actief waren voordat de verbinding werd verbroken (standaard false).

Verbinding

Wanneer de client succesvol verbinding maakt met Bitget-servers, wordt de gebeurtenis OnConnect gegenereerd. Nadat de gebeurtenis OnConnect is gegenereerd, kunt u beginnen met het verzenden en ontvangen van berichten naar/van Bitget-servers. Als u verbinding maakt met het privé WebSocket-kanaal, moet u wachten totdat de gebeurtenis OnBitgetAuthentication is gegenereerd en controleren of de parameter success true is, voordat u zich op een kanaal abonneert.

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;

Gebeurtenissen

De Bitget-client implementeert de volgende gebeurtenissen om de verbindingsstroom te beheren en gegevens te ontvangen die door de WebSocket-server zijn verzonden:

• OnConnect: geactiveerd wanneer de websocket-client verbinding maakt met de WebSocket-server.
• OnDisconnect: gegenereerd wanneer de WebSocket-client de verbinding verbreekt met de WebSocket-server.
• OnBitgetAuthentication: wordt geactiveerd wanneer de client zich authenticateert bij de Private WebSocket Server.
• OnBitgetSubscribe: wanneer de client zich abonneert op een websocket-kanaal.
• OnBitgetUnSubscribe: wanneer de client zich afmeldt van een websocket-kanaal.
• OnBitgetData: wanneer de client gegevens ontvangt van de server.
• OnBitgetError: wanneer er een fout optreedt tijdens de Bitget-websocketverbinding.
• OnBitgetHTTPException: wanneer er een fout optreedt tijdens het REST-verzoek.

WebSocket API

De websocketfeed biedt realtime marktgegevensupdates voor orders en transacties.

U kunt zich abonneren op de volgende kanalen:

Methode	Openbaar or Privé	Beschrijving
SubscribeTicker	Publiek	Abonneer op de tickerstream voor een instrument.
SubscribeTrade	Publiek	Abonneer u op de stream van recente handel.
SubscribeCandle	Publiek	Abonneer u op de kandelaarstream. Ondersteunt meerdere intervallen (bijv. candle1m, candle5m, candle1H).
SubscribeOrderBook	Publiek	Subscribe to the order book stream. Supports different depth levels.
SubscribeOrders	Privé	Abonneren op orderupdates. Vereist authenticatie.
SubscribePositions	Privé	Abonneer op positie-updates. Vereist authenticatie.
SubscribeAccount	Privé	Abonneer op updates van het accountsaldo. Vereist authenticatie.

Hieronder vindt u een voorbeeld van het abonneren op privé-websocketkanalen na een succesvolle authenticatie.

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

REST API

De REST API biedt openbare en privémethoden om gegevens op te vragen van markten en privéaccounts. Toegang tot de REST API via de eigenschap REST_API van het component.

Methode	Publiek / Privé	Beschrijving
GetServerTime	Publiek	De servertijd ophalen.
GetTickers	Publiek	Get ticker information for one or all symbols.
GetOrderBook	Publiek	Haal het orderboek op voor een symbool.
GetCandles	Publiek	Candlestick-/kline-gegevens voor een symbool ophalen.
GetRecentTrades	Publiek	De meest recente transacties voor een symbool ophalen.
PlaceOrder	Privé	Plaats een nieuwe order.
CancelOrder	Privé	Cancel an existing order.
GetOpenOrders	Privé	Haal de lijst met openstaande orders op.
GetOrderDetail	Privé	Details van een specifieke order ophalen.
GetOrderHistory	Privé	Haal de ordergeschiedenis op.
GetAccountAssets	Privé	Accountactivainformatie ophalen.
GetAccountInfo	Privé	Accountinformatie ophalen.

Hieronder vindt u een voorbeeld van het gebruik van de 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');