API Crypto.com

Crypto.com

API supportate

• WebSocket API: connette a un server websocket e fornisce aggiornamenti in tempo reale dei dati di mercato, variazioni dell'account e altro.
• REST API: invia richieste HTTP per ottenere dati di mercato, piazzare ordini, dati dell'account...

Proprietà

Utilizzare la proprietà Channel per selezionare il tipo di canale:

• cccMarket: connette alla Market WebSocket API per i dati di mercato pubblici.
• cccUser: si connette all'API WebSocket User per i dati privati dell'account (richiede autenticazione).

È possibile configurare le seguenti proprietà nella proprietà CryptoCom.

• ApiKey: può richiedere una nuova chiave api nel Suo account Crypto.com, copi semplicemente il valore in questa proprietà. Richiesta per i canali privati e le chiamate REST API autenticate.
• ApiSecret: è il valore segreto dell'api.
• Resubscribe: se abilitato, dopo una riconnessione il client si iscrive di nuovo automaticamente ai canali che erano attivi prima della disconnessione (per impostazione predefinita false).

Connessione

Quando il client si connette con successo ai server Crypto.com, viene attivato l'evento OnConnect. Dopo che l'evento OnConnect è stato attivato, è possibile iniziare a inviare e ricevere messaggi da/verso i server Crypto.com. Se ci si connette al canale Utente, è necessario attendere che l'evento OnCryptoComAuthentication venga attivato e verificare che il parametro success sia true, prima di iscriversi a qualsiasi canale privato.

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;

Eventi

Il client Crypto.com implementa i seguenti eventi per controllare il flusso di connessione e ottenere i dati inviati dal server WebSocket:

• OnConnect: attivato quando il client websocket si connette al server WebSocket.
• OnDisconnect: attivato quando il client websocket si disconnette dal WebSocket Server.
• OnCryptoComAuthentication: generato quando il client si autentica con il Server WebSocket Privato.
• OnCryptoComSubscribe: quando il client si iscrive a un canale websocket.
• OnCryptoComUnSubscribe: quando il client annulla la sottoscrizione a un canale websocket.
• OnCryptoComData: quando il client riceve dati dal server.
• OnCryptoComError: quando si verifica un errore durante la connessione websocket a Crypto.com.
• OnCryptoComHTTPException: quando si verifica un errore durante la richiesta REST.

WebSocket API

Il feed websocket fornisce aggiornamenti in tempo reale sui dati di mercato per ordini e transazioni.

È possibile sottoscriversi ai seguenti canali di mercato (pubblici):

Method	Description
SubscribeTicker	Iscrizione al flusso ticker per uno strumento. Fornisce dati in tempo reale su prezzi e volumi.
SubscribeTrade	Si iscrive allo stream dei trade recenti per uno strumento.
SubscribeCandlestick	Sottoscrivi al flusso di candele. Supporta più intervalli (ad es. 5m, 15m, 30m, 1h, 4h, 1D).
SubscribeBook	Sottoscrivi al flusso dell'order book. Supporta livelli di profondità configurabili (ad es. 10, 50).

È possibile sottoscriversi ai seguenti canali utente (privati, richiedono autenticazione):

Method	Description
SubscribeOrders	Iscriviti agli aggiornamenti degli ordini. Filtrare facoltativamente per nome strumento.
SubscribeUserTrades	Sottoscrivere gli aggiornamenti sulle operazioni dell'utente. Facoltativamente filtrare per nome strumento.
SubscribeBalance	Sottoscrivi gli aggiornamenti del saldo per il tuo account.

Di seguito è riportato un esempio di iscrizione ai canali di mercato.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oCryptoCom.SubscribeTicker('BTC_USDT');
  oCryptoCom.SubscribeBook('BTC_USDT', '10');
end;

REST API

La REST API fornisce metodi pubblici e privati per richiedere dati dai mercati e dagli account privati. Acceda alla REST API tramite la proprietà REST_API del componente.

Method	Public / Private	Description
GetInstruments	Public	Recupera l'elenco degli strumenti disponibili.
GetTicker	Public	Ottieni informazioni sul ticker per uno o tutti gli strumenti.
GetOrderBook	Public	Ottiene l'order book per uno strumento.
GetTrades	Public	Recupera le operazioni più recenti per uno strumento.
GetCandlestick	Public	Recupera i dati candlestick/kline per uno strumento.
CreateOrder	Privato	Crea un nuovo ordine. Supporta gli ordini limit e market.
CancelOrder	Privato	Annulla un ordine esistente.
CancelAllOrders	Privato	Annulla tutti gli ordini aperti per uno strumento.
GetOpenOrders	Privato	Ottenere l'elenco degli ordini aperti.
GetOrderDetail	Privato	Ottiene i dettagli di un ordine specifico.
GetOrderHistory	Privato	Recupera la cronologia degli ordini.
GetAccountSummary	Privato	Ottiene le informazioni di riepilogo del conto.

Di seguito è riportato un esempio di utilizzo della 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;