API Crypto.com

Crypto.com

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

cccMarket : se connecter à l'API WebSocket Market pour les données de marché publiques.
cccUser : se connecter à l'API WebSocket utilisateur pour les données de compte privées (nécessite une authentification).

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

ApiKey : vous pouvez demander une nouvelle clé api dans votre compte Crypto.com, copiez simplement la valeur dans cette propriété. Requise pour les canaux privés et les appels API REST authentifiés.
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 Crypto.com, l'événement OnConnect est déclenché. Après le déclenchement de OnConnect, vous pouvez commencer à envoyer et recevoir des messages vers/depuis les serveurs Crypto.com. Si vous vous connectez au canal utilisateur, vous devez attendre que l'événement OnCryptoComAuthentication soit déclenché et vérifier que le paramètre success est true avant de vous abonner à un canal privé.


oClient := TsgcWebSocketClient.Create(nil);
oCryptoCom := TsgcWS_API_CryptoCom.Create(nil);
oCryptoCom.Client := oClient;
oCryptoCom.CryptoCom.ApiKey := 'your_api_key';
oCryptoCom.CryptoCom.ApiSecret := 'your_api_secret';
oCryptoCom.Channel := cccMarket;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#CryptoCom Connected');
end;

Événements

Le client Crypto.com 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.
OnCryptoComAuthentication : déclenché lorsque le client s'authentifie auprès du serveur WebSocket privé.
OnCryptoComSubscribe: lorsque le client s'abonne à un canal websocket.
OnCryptoComUnSubscribe : lorsque le client se désabonne d'un canal websocket.
OnCryptoComData: lorsque le client reçoit des données du serveur.
OnCryptoComError : lorsqu'une erreur survient lors de la connexion websocket Crypto.com.
OnCryptoComHTTPException : 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 de marché suivants (publics) :

Méthode	Description
SubscribeTicker	S'abonner au flux de ticker pour un instrument. Fournit des données de prix et de volume en temps réel.
SubscribeTrade	S'abonner au flux de trades récents pour un instrument.
SubscribeCandlestick	S'abonner au flux de bougies japonaises. Supporte plusieurs intervalles (ex. 5m, 15m, 30m, 1h, 4h, 1D).
SubscribeBook	S'abonner au flux du carnet d'ordres. Prend en charge des niveaux de profondeur configurables (ex. 10, 50).

Vous pouvez vous abonner aux canaux utilisateur suivants (privés, nécessitent une authentification) :

Méthode	Description
SubscribeOrders	S'abonner aux mises à jour des ordres. Filtrer optionnellement par nom d'instrument.
SubscribeUserTrades	S'abonner aux mises à jour des trades utilisateur. Filtrer optionnellement par nom d'instrument.
SubscribeBalance	Abonnez-vous aux mises à jour de solde de votre compte.

Voici un exemple d'abonnement aux canaux de marché.


procedure OnConnect(Connection: TsgcWSConnection);
begin
  oCryptoCom.SubscribeTicker('BTC_USDT');
  oCryptoCom.SubscribeBook('BTC_USDT', '10');
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
GetInstruments	Public	Obtenir la liste des instruments disponibles.
GetTicker	Public	Obtenir des informations de ticker pour un ou tous les instruments.
GetOrderBook	Public	Obtenir le carnet d'ordres pour un instrument.
GetTrades	Public	Obtenir les transactions les plus récentes pour un instrument.
GetCandlestick	Public	Obtenir les données de chandelier/kline pour un instrument.
CreateOrder	Privé	Créer un nouvel ordre. Prend en charge les ordres à cours limité et au marché.
CancelOrder	Privé	Annuler un ordre existant.
CancelAllOrders	Privé	Annuler tous les ordres ouverts pour un instrument.
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.
GetAccountSummary	Privé	Obtenir le résumé du compte.

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


oCryptoCom := TsgcWS_API_CryptoCom.Create(nil);
oCryptoCom.CryptoCom.ApiKey := 'your_api_key';
oCryptoCom.CryptoCom.ApiSecret := 'your_api_secret';
// Get instruments
oCryptoCom.REST_API.GetInstruments;
// Create an order
oCryptoCom.REST_API.CreateOrder('BTC_USDT', 'BUY', 'MARKET', '', '0.001');
// Get account summary
oCryptoCom.REST_API.GetAccountSummary;