API GateIO

Gate.io

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

• giocSpot: połącz z WebSocket API Spot.
• giocFutures: nawiązuje połączenie z WebSocket API Futures.

Następujące właściwości można skonfigurować we właściwości GateIO.

• ApiKey: Nowy klucz API można wygenerować na koncie Gate.io, a następnie skopiować jego wartość do tej właściwości. Jeśli właściwość APIKey jest ustawiona, klient uwierzytelni się na prywatnym serwerze. Jeśli jest pusta, dostępne będą wyłącznie kanały publiczne.
• 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

Gdy klient pomyślnie połączy się z serwerami Gate.io, wywoływane jest zdarzenie OnConnect. Po wywołaniu zdarzenia OnConnect można rozpocząć wysyłanie i odbieranie wiadomości do i z serwerów Gate.io. Jeśli nawiązywane jest połączenie z prywatnym kanałem websocket, należy poczekać na wywołanie zdarzenia OnGateIOAuthentication i sprawdzić, czy parametr success ma wartość true, zanim nastąpi subskrypcja jakiegokolwiek prywatnego kanału.

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;

Zdarzenia

Klient GateIO implementuje następujące zdarzenia do kontrolowania przepływu połączeń i pobierania 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.
• OnGateIOAuthentication: wywoływane, gdy klient uwierzytelnia się na prywatnym serwerze WebSocket.
• OnGateIOSubscribe: gdy klient subskrybuje kanał websocket.
• OnGateIOUnSubscribe: wywoływane, gdy klient anuluje subskrypcję kanału WebSocket.
• OnGateIOData: wywoływane, gdy klient odbiera dane z serwera.
• OnGateIOError: wywoływane w przypadku wystąpienia błędu podczas połączenia WebSocket z GateIO.
• OnGateIOHTTPException: 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żna subskrybować następujące kanały:

Metoda	Publiczny lub prywatny	Opis
SubscribeTicker	Publiczny	Subskrybuje strumień tickera dla symbolu.
SubscribeTrades	Publiczny	Subskrybuj strumień ostatnich transakcji.
SubscribeCandlesticks	Publiczny	Subskrybuj strumień świec. Obsługuje wiele interwałów (np. 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Publiczny	Subskrybuj strumień arkusza zamówień. Obsługuje konfigurowalne poziomy głębokości i interwały aktualizacji.
SubscribeOrders	Prywatny	Subskrypcja aktualizacji zleceń. Wymaga uwierzytelnienia.
SubscribeBalances	Prywatny	Subskrypcja aktualizacji salda. Wymaga uwierzytelnienia.

Poniżej znajduje się przykład subskrybowania publicznych kanałów WebSocket.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
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
GetCurrencyPairs	Publiczny	Pobierz informacje o dostępnych parach walutowych.
GetTickers	Publiczny	Pobierz informacje o tickerze dla jednej lub wszystkich par walutowych.
GetOrderBook	Publiczny	Pobierz księgę zleceń dla pary walutowej.
GetCandlesticks	Publiczny	Pobieranie danych świecowych/kline dla pary walutowej.
GetTrades	Publiczny	Pobierz ostatnie transakcje dla pary walutowej.
PlaceOrder	Prywatny	Składa nowe zlecenie. Obsługuje zlecenia limit i market.
CancelOrder	Prywatny	Anuluje istniejące zlecenie.
GetOrder	Prywatny	Pobierz szczegóły określonego zlecenia.
GetOpenOrders	Prywatny	Pobiera listę otwartych zleceń.
GetSpotAccounts	Prywatny	Pobierz informacje o koncie spot.

Poniżej znajduje się przykład użycia 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');