API GateIO

Gate.io

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é GateIOChannel pour sélectionner le type de canal :

• giocSpot : connexion à l'API WebSocket Spot.
• giocFutures : connexion à l'API WebSocket Futures.

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

• ApiKey : vous pouvez demander une nouvelle clé API dans votre compte Gate.io ; copiez simplement la valeur dans cette propriété. Si la clé API est définie, le client s'authentifiera auprès du serveur privé. Si elle est vide, seuls les canaux publics seront disponibles.
• ApiSecret : c'est la valeur secrète de l'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 Gate.io, 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 Gate.io. Si vous vous connectez au canal WebSocket privé, vous devez attendre que l'événement OnGateIOAuthentication soit déclenché et vérifier que le paramètre success est true, avant de vous abonner à n'importe quel canal privé.

oClient := TsgcWebSocketClient.Create(nil);
oGateIO := TsgcWS_API_GateIO.Create(nil);
oGateIO.Client := oClient;
oGateIO.GateIO.ApiKey := 'your_api_key';
oGateIO.GateIO.ApiSecret := 'your_api_secret';
oGateIO.GateIOChannel := giocSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#GateIO Connected');
end;

Événements

Le client GateIO implémente les événements suivants pour contrôler le flux de connexion et obtenir les données envoyées par 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.
• OnGateIOAuthentication : déclenché lorsque le client s'authentifie auprès du serveur WebSocket privé.
• OnGateIOSubscribe : lorsque le client s'abonne à un canal websocket.
• OnGateIOUnSubscribe : lorsque le client se désabonne d'un canal websocket.
• OnGateIOData : lorsque le client reçoit des données du serveur.
• OnGateIOError : lorsqu'une erreur survient lors de la connexion websocket GateIO.
• OnGateIOHTTPException: lorsqu'une erreur survient 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 ticker pour un symbole.
SubscribeTrades	Public	S'abonner au flux des transactions récentes.
SubscribeCandlesticks	Public	S'abonner au flux de bougies. Prend en charge plusieurs intervalles (par exemple 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Public	S'abonner au flux du carnet d'ordres. Prend en charge des niveaux de profondeur et des intervalles de mise à jour configurables.
SubscribeOrders	Privé	S'abonner aux mises à jour des ordres. Nécessite une authentification.
SubscribeBalances	Privé	S'abonner aux mises à jour de solde. Nécessite une authentification.

Trouvez ci-dessous un exemple d'abonnement aux canaux websocket publics.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
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
GetCurrencyPairs	Public	Obtenir des informations sur les paires de devises disponibles.
GetTickers	Public	Obtenir les informations de cours pour une ou toutes les paires de devises.
GetOrderBook	Public	Obtenir le carnet d'ordres pour une paire de devises.
GetCandlesticks	Public	Obtenir les données chandeliers/kline pour une paire de devises.
GetTrades	Public	Obtenir les transactions les plus récentes pour une paire de devises.
PlaceOrder	Privé	Placer un nouvel ordre. Prend en charge les ordres à cours limité et au marché.
CancelOrder	Privé	Annuler un ordre existant.
GetOrder	Privé	Obtenir les détails d'un ordre spécifique.
GetOpenOrders	Privé	Obtenir la liste des ordres ouverts.
GetSpotAccounts	Privé	Obtenir les informations du compte spot.

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

oGateIO := TsgcWS_API_GateIO.Create(nil);
oGateIO.GateIO.ApiKey := 'your_api_key';
oGateIO.GateIO.ApiSecret := 'your_api_secret';
// Get tickers
oGateIO.REST_API.GetTickers('BTC_USDT');
// Place an order
oGateIO.REST_API.PlaceOrder('BTC_USDT', 'buy', '0.001', '50000', 'limit');