API Crypto.com

Crypto.com

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 Channel, aby wybrać typ kanału:

cccMarket: połączenie z Market WebSocket API w celu uzyskania publicznych danych rynkowych.
cccUser: połącz się z WebSocket API użytkownika w celu uzyskania prywatnych danych konta (wymagane uwierzytelnienie).

Poniżej przedstawiono właściwości, które można skonfigurować we właściwości CryptoCom.

ApiKey: nowy klucz API można uzyskać na koncie Crypto.com; należy skopiować jego wartość do tej właściwości. Wymagany dla kanałów prywatnych i uwierzytelnionych wywołań REST API.
ApiSecret: to tajny klucz 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

Po pomyślnym połączeniu klienta z serwerami Crypto.com wywoływane jest zdarzenie OnConnect. Po wywołaniu zdarzenia OnConnect można zacząć wysyłać i odbierać wiadomości do/z serwerów Crypto.com. Jeśli następuje połączenie z kanałem użytkownika, należy poczekać na wywołanie zdarzenia OnCryptoComAuthentication i sprawdzić, czy parametr sukcesu wynosi True, przed subskrybowaniem jakiegokolwiek prywatnego kanału.


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;

Zdarzenia

Klient Crypto.com implementuje następujące zdarzenia do sterowania przepływem połączenia i odbierania danych wysyłanych przez serwer WebSocket:

OnConnect: wywoływane, gdy klient websocket łączy się z serwerem WebSocket.
OnDisconnect: wywoływane, gdy klient WebSocket rozłącza się z serwerem WebSocket.
OnCryptoComAuthentication: wywoływane, gdy klient uwierzytelnia się na prywatnym serwerze WebSocket.
OnCryptoComSubscribe: wywoływane, gdy klient subskrybuje kanał websocket.
OnCryptoComUnSubscribe: wywoływane, gdy klient anuluje subskrypcję kanału WebSocket.
OnCryptoComData: wywoływane, gdy klient odbiera dane z serwera.
OnCryptoComError: wywoływane w przypadku wystąpienia błędu podczas połączenia WebSocket z Crypto.com.
OnCryptoComHTTPException: 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żesz subskrybować następujące kanały rynkowe (publiczne):

Metoda	Opis
SubscribeTicker	Subskrybuj strumień tickera dla instrumentu. Dostarcza dane o cenie i wolumenie w czasie rzeczywistym.
SubscribeTrade	Subskrybuj strumień ostatnich transakcji dla instrumentu.
SubscribeCandlestick	Subskrybuj strumień świec. Obsługiwane są różne interwały (np. 5m, 15m, 30m, 1h, 4h, 1D).
SubscribeBook	Subskrybuje strumień arkusza zleceń. Obsługuje konfigurowalne poziomy głębokości (np. 10, 50).

Można subskrybować następujące kanały użytkownika (prywatne, wymagają uwierzytelnienia):

Metoda	Opis
SubscribeOrders	Subskrybuje aktualizacje transakcji użytkownika dla instrumentu.
SubscribeUserTrades	Subskrybuj aktualizacje transakcji użytkownika. Opcjonalnie filtruj według nazwy instrumentu.
SubscribeBalance	Subskrybuj aktualizacje salda dla swojego konta.

Poniżej znajduje się przykład subskrypcji kanałów rynkowych.


procedure OnConnect(Connection: TsgcWSConnection);
begin
  oCryptoCom.SubscribeTicker('BTC_USDT');
  oCryptoCom.SubscribeBook('BTC_USDT', '10');
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
GetInstruments	Publiczny	Pobierz listę dostępnych instrumentów.
GetTicker	Publiczny	Pobierz informacje o tickerze dla jednego lub wszystkich instrumentów.
GetOrderBook	Publiczny	Pobierz arkusz zleceń dla instrumentu.
GetTrades	Publiczny	Pobiera ostatnie transakcje dla instrumentu.
GetCandlestick	Publiczny	Pobierz dane świec/kline dla instrumentu.
CreateOrder	Prywatny	Tworzy nowe zlecenie. Obsługuje zlecenia z limitem ceny i rynkowe.
CancelOrder	Prywatny	Anuluje istniejące zlecenie.
CancelAllOrders	Prywatny	Anuluj wszystkie otwarte zlecenia dla instrumentu.
GetOpenOrders	Prywatny	Pobiera listę otwartych zleceń.
GetOrderDetail	Prywatny	Pobierz szczegóły określonego zlecenia.
GetOrderHistory	Prywatny	Pobierz historię zleceń.
GetAccountSummary	Prywatny	Pobierz podsumowanie informacji o koncie.

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


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;