API Crypto.com

Crypto.com

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 Channel om het kanaaltype te selecteren:

• cccMarket: verbinding maken met de Market WebSocket API voor openbare marktgegevens.
• cccUser: maak verbinding met de User WebSocket API voor privé-accountgegevens (vereist authenticatie).

U kunt de volgende eigenschappen configureren in de eigenschap CryptoCom.

• ApiKey: u kunt een nieuwe API-sleutel aanvragen in uw Crypto.com-account; kopieer de waarde naar deze eigenschap. Vereist voor privékanalen en geverifieerde REST API-aanroepen.
• ApiSecret: het is de geheime waarde van de API.
• 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 met succes verbinding maakt met de Crypto.com-servers, wordt het event OnConnect geactiveerd. Nadat het event OnConnect is geactiveerd, kunt u beginnen met het verzenden en ontvangen van berichten van/naar de Crypto.com-servers. Als u verbinding maakt met het User channel, moet u wachten tot het event OnCryptoComAuthentication is geactiveerd en controleren of de success-parameter true is, voordat u zich op een privaat channel abonneert.

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;

Gebeurtenissen

De Crypto.com-client implementeert de volgende gebeurtenissen om de verbindingsstroom te beheren en gegevens te ontvangen die door de WebSocket-server worden 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.
• OnCryptoComAuthentication: wordt geactiveerd wanneer de client zich authenticeert bij de privé WebSocket-server.
• OnCryptoComSubscribe: wanneer de client zich abonneert op een websocket-kanaal.
• OnCryptoComUnSubscribe: wanneer de client zich afmeldt van een websocketkanaal.
• OnCryptoComData: wanneer de client gegevens van de server ontvangt.
• OnCryptoComError: wanneer er een fout optreedt tijdens de Crypto.com WebSocket-verbinding.
• OnCryptoComHTTPException: 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 Market-kanalen (publiek):

Methode	Beschrijving
SubscribeTicker	Abonneer op de ticker-stream voor een instrument. Geeft realtime prijs- en volumegegevens.
SubscribeTrade	Abonneer u op de stroom van recente transacties voor een instrument.
SubscribeCandlestick	Abonneer op de candlestick-stream. Ondersteunt meerdere intervallen (bijv. 5m, 15m, 30m, 1h, 4h, 1D).
SubscribeBook	Abonneer op de orderboekstream. Ondersteunt configureerbare diepteniveaus (bijv. 10, 50).

U kunt zich abonneren op de volgende gebruikerskanalen (privé, vereisen authenticatie):

Methode	Beschrijving
SubscribeOrders	Abonneer op orderupdates. Optioneel filteren op instrumentnaam.
SubscribeUserTrades	Abonneren op updates van gebruikerstransacties. Optioneel filteren op instrumentnaam.
SubscribeBalance	Abonneer u op saldo-updates voor uw account.

Hieronder vindt u een voorbeeld van het abonneren op marktkanalen.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oCryptoCom.SubscribeTicker('BTC_USDT');
  oCryptoCom.SubscribeBook('BTC_USDT', '10');
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
GetInstruments	Publiek	Haal de lijst met beschikbare instrumenten op.
GetTicker	Publiek	Haal tickerinformatie op voor één of alle instrumenten.
GetOrderBook	Publiek	Haal het orderboek op voor een instrument.
GetTrades	Publiek	Haal de meest recente transacties op voor een instrument.
GetCandlestick	Publiek	Haal candlestick/kline-gegevens op voor een instrument.
CreateOrder	Privé	Maak een nieuwe order aan. Ondersteunt limiet- en marktorders.
CancelOrder	Privé	Cancel an existing order.
CancelAllOrders	Privé	Annuleer alle openstaande orders voor een instrument.
GetOpenOrders	Privé	Haal de lijst met openstaande orders op.
GetOrderDetail	Privé	Details van een specifieke order ophalen.
GetOrderHistory	Privé	Haal de ordergeschiedenis op.
GetAccountSummary	Privé	Accountoverzichtsinformatie ophalen.

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