API Bitget

Bitget

APIs prises en charge

• API WebSocket : se connecter à un serveur WebSocket et fournit des mises à jour de données de marché en temps réel, des changements de compte et plus encore.
• API REST : envoyer des requêtes HTTP pour obtenir des données de marché, passer des ordres, des données de compte...

Propriétés

Utilisez la propriété BitgetChannel pour sélectionner le type de canal :

• bgcSpot : se connecter à l'API WebSocket Spot.
• bgcFutures : se connecter à l'API WebSocket Futures.

Vous pouvez configurer les propriétés suivantes dans la propriété Bitget.

• ApiKey : vous pouvez demander une nouvelle clé API dans votre compte Bitget, copiez simplement la valeur dans cette propriété. Si la clé APIKey est définie, le client se connectera au serveur websocket privé. Si elle est vide, il se connectera au serveur WebSocket public.
• ApiSecret : c'est la valeur secrète de l'API.
• Passphrase : c'est la chaîne personnalisée définie lors de la création d'une nouvelle clé API.
• Resubscribe : si activé, après une reconnexion le client se réabonne automatiquement aux canaux qui étaient actifs avant la déconnexion (par défaut false).

Connexion

Lorsque le client se connecte avec succès aux serveurs Bitget, l'événement OnConnect est déclenché. Après le déclenchement de l'événement OnConnect, vous pouvez commencer à envoyer et à recevoir des messages vers/depuis les serveurs Bitget. Si vous vous connectez au canal WebSocket privé, vous devez attendre que l'événement OnBitgetAuthentication soit déclenché et vérifier que le paramètre success est true, avant de vous abonner à n'importe quel canal.

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;

Événements

Le client Bitget implémente les événements suivants pour contrôler le flux de connexion et obtenir les données envoyées depuis le serveur WebSocket :

• OnConnect : déclenché lorsque le client WebSocket se connecte au serveur WebSocket.
• OnDisconnect : déclenché lorsque le client websocket se déconnecte du serveur WebSocket.
• OnBitgetAuthentication : déclenché lorsque le client s'authentifie auprès du serveur WebSocket privé.
• OnBitgetSubscribe : lorsque le client s'abonne à un canal websocket.
• OnBitgetUnSubscribe : lorsque le client se désabonne d'un canal websocket.
• OnBitgetData : lorsque le client reçoit des données du serveur.
• OnBitgetError : lorsqu'une erreur survient pendant la connexion WebSocket Bitget.
• OnBitgetHTTPException : lorsqu'une erreur se produit lors de la requête REST.

API WebSocket

Le flux websocket fournit des mises à jour de données de marché en temps réel pour les ordres et les transactions.

Vous pouvez vous abonner aux canaux suivants :

Méthode	Public ou privé	Description
SubscribeTicker	Public	S'abonner au flux de ticker pour un instrument.
SubscribeTrade	Public	S'abonner au flux des transactions récentes.
SubscribeCandle	Public	S'abonner au flux de bougies. Prend en charge plusieurs intervalles (par exemple candle1m, candle5m, candle1H).
SubscribeOrderBook	Public	S'abonner au flux du carnet d'ordres. Prend en charge différents niveaux de profondeur.
SubscribeOrders	Privé	S'abonner aux mises à jour des ordres. Nécessite une authentification.
SubscribePositions	Privé	S'abonner aux mises à jour de positions. Nécessite une authentification.
SubscribeAccount	Privé	Abonnez-vous aux mises à jour du solde du compte. Nécessite une authentification.

Vous trouverez ci-dessous un exemple d'abonnement aux canaux websocket privés après une authentification réussie.

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

REST API

L'API REST fournit des méthodes publiques et privées pour demander des données aux marchés et comptes privés. Accédez à l'API REST via la propriété REST_API du composant.

Méthode	Public / Privé	Description
GetServerTime	Public	Obtenir l'heure du serveur.
GetTickers	Public	Obtenir les informations de ticker pour un ou tous les symboles.
GetOrderBook	Public	Obtenir le carnet d'ordres pour un symbole.
GetCandles	Public	Obtenir les données de chandelier/kline pour un symbole.
GetRecentTrades	Public	Obtenir les transactions les plus récentes pour un symbole.
PlaceOrder	Privé	Passer un nouvel ordre.
CancelOrder	Privé	Annuler un ordre existant.
GetOpenOrders	Privé	Obtenir la liste des ordres ouverts.
GetOrderDetail	Privé	Obtenir les détails d'un ordre spécifique.
GetOrderHistory	Privé	Obtenir l'historique des ordres.
GetAccountAssets	Privé	Obtenir les informations sur les actifs du compte.
GetAccountInfo	Privé	Obtenir les informations du compte.

Vous trouverez ci-dessous un exemple d'utilisation de l'API REST.

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');