API GateIO

Gate.io

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à GateIOChannel per selezionare il tipo di canale:

• giocSpot: connette all'API WebSocket Spot.
• giocFutures: connettersi all'API WebSocket Futures.

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

• ApiKey: è possibile richiedere una nuova chiave API nel proprio account Gate.io; copiare il valore in questa proprietà. Se APIKey è impostato, il client si autenticherà sul server privato. Se è vuoto, saranno disponibili solo i canali pubblici.
• 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 Gate.io, viene generato l'evento OnConnect. Dopo che l'evento OnConnect è stato generato, è possibile iniziare a inviare e ricevere messaggi da/verso i server Gate.io. Se ci si connette al canale WebSocket privato, è necessario attendere che l'evento OnGateIOAuthentication venga generato e verificare che il parametro success sia true, prima di sottoscrivere qualsiasi canale privato.

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;

Eventi

Il client GateIO 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.
• OnGateIOAuthentication: attivato quando il client si autentica con il Private WebSocket Server.
• OnGateIOSubscribe: quando il client si sottoscrive a un canale websocket.
• OnGateIOUnSubscribe: quando il client annulla la sottoscrizione a un canale websocket.
• OnGateIOData: quando il client riceve dati dal server.
• OnGateIOError: quando si verifica un errore durante la connessione websocket a GateIO.
• OnGateIOHTTPException: in caso di errore durante la richiesta REST.

WebSocket API

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

Può sottoscrivere i seguenti canali:

Method	Pubblico o Privato	Description
SubscribeTicker	Public	Iscrizione allo stream ticker per un simbolo.
SubscribeTrades	Public	Sottoscrivi allo stream degli scambi recenti.
SubscribeCandlesticks	Public	Si iscriva allo stream candlestick. Supporta più intervalli (per esempio 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Public	Abbonati al flusso del libro degli ordini. Supporta livelli di profondità e intervalli di aggiornamento configurabili.
SubscribeOrders	Privato	Sottoscrivi agli aggiornamenti degli ordini. Richiede autenticazione.
SubscribeBalances	Privato	Sottoscrivere gli aggiornamenti del saldo. Richiede l'autenticazione.

Di seguito è riportato un esempio di sottoscrizione a canali WebSocket pubblici.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
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
GetCurrencyPairs	Public	Ottiene informazioni sulle coppie di valute disponibili.
GetTickers	Public	Ottieni informazioni sul ticker per una o tutte le coppie di valute.
GetOrderBook	Public	Ottiene il book degli ordini per una coppia di valute.
GetCandlesticks	Public	Ottenere i dati candlestick/kline per una coppia di valute.
GetTrades	Public	Ottieni gli scambi più recenti per una coppia di valute.
PlaceOrder	Privato	Inserisce un nuovo ordine. Supporta ordini limite e di mercato.
CancelOrder	Privato	Annulla un ordine esistente.
GetOrder	Privato	Ottiene i dettagli di un ordine specifico.
GetOpenOrders	Privato	Ottenere l'elenco degli ordini aperti.
GetSpotAccounts	Privato	Ottiene le informazioni sull'account spot.

Di seguito è riportato un esempio di utilizzo della REST API.

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');