API GateIO

Gate.io

Unterstützte APIs

• WebSocket API: verbindet sich mit einem WebSocket-Server und stellt Echtzeit-Marktdaten-Updates, Kontoänderungen und mehr bereit.
• REST API: HTTP-Requests senden, um Marktdaten abzurufen, Orders zu platzieren, Kontodaten abzurufen...

Properties

Verwenden Sie die Eigenschaft GateIOChannel, um den Kanaltyp auszuwählen:

• giocSpot: verbindet sich mit der Spot-WebSocket-API.
• giocFutures: verbindet sich mit der Futures-WebSocket-API.

Sie können die folgenden Eigenschaften in der GateIO-Eigenschaft konfigurieren.

• ApiKey: Sie können in Ihrem Gate.io-Konto einen neuen API-Schlüssel anfordern, kopieren Sie den Wert einfach in diese Eigenschaft. Wenn der APIKey gesetzt ist, authentifiziert sich der Client gegenüber dem privaten Server. Ist er leer, sind nur öffentliche Channels verfügbar.
• ApiSecret: ist der geheime Wert der API.
• Resubscribe: wenn aktiviert, abonniert der Client nach einer Wiederverbindung automatisch erneut die Kanäle, die vor der Trennung aktiv waren (standardmäßig false).

Connection

Wenn der Client erfolgreich eine Verbindung zu den Gate.io-Servern herstellt, wird das Ereignis OnConnect ausgelöst. Nachdem das Ereignis OnConnect ausgelöst wurde, können Sie beginnen, Nachrichten an die Gate.io-Server zu senden und von ihnen zu empfangen. Wenn Sie sich mit dem privaten WebSocket-Kanal verbinden, müssen Sie warten, bis das Ereignis OnGateIOAuthentication ausgelöst wird, und prüfen, ob der success-Parameter true ist, bevor Sie einen privaten Kanal abonnieren.

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;

Ereignisse

Der GateIO-Client implementiert die folgenden Ereignisse, um den Verbindungsablauf zu steuern und vom WebSocket-Server gesendete Daten zu erhalten:

• OnConnect: wird ausgelöst, wenn sich der WebSocket-Client mit dem WebSocket-Server verbindet.
• OnDisconnect: wird ausgelöst, wenn der WebSocket-Client die Verbindung zum WebSocket-Server trennt.
• OnGateIOAuthentication: wird ausgelöst, wenn sich der Client gegenüber dem privaten WebSocket-Server authentifiziert.
• OnGateIOSubscribe: wenn der Client einen WebSocket-Kanal abonniert.
• OnGateIOUnSubscribe: wenn der Client ein WebSocket-Kanalabonnement kündigt.
• OnGateIOData: wenn der Client Daten vom Server empfängt.
• OnGateIOError: wenn ein Fehler während der GateIO-WebSocket-Verbindung auftritt.
• OnGateIOHTTPException: wenn während der REST-Anfrage ein Fehler auftritt.

WebSocket API

Der WebSocket-Feed stellt Echtzeit-Marktdatenaktualisierungen für Orders und Trades bereit.

Sie können die folgenden Kanäle abonnieren:

Methode	Öffentlich oder privat	Beschreibung
SubscribeTicker	Öffentlich	Abonniert den Ticker-Stream für ein Symbol.
SubscribeTrades	Öffentlich	Den Stream der jüngsten Trades abonnieren.
SubscribeCandlesticks	Öffentlich	Abonniert den Candlestick-Stream. Unterstützt mehrere Intervalle (z. B. 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Öffentlich	Abonniert den Order-Book-Stream. Unterstützt konfigurierbare Tiefenebenen und Aktualisierungsintervalle.
SubscribeOrders	Private	Abonniert Order-Updates. Erfordert Authentifizierung.
SubscribeBalances	Private	Abonniert Guthaben-Aktualisierungen. Erfordert Authentifizierung.

Nachfolgend finden Sie ein Beispiel für das Abonnieren öffentlicher WebSocket-Kanäle.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
end;

REST API

Die REST-API stellt öffentliche und private Methoden bereit, um Daten von Märkten und privaten Konten anzufordern. Greifen Sie über die Eigenschaft REST_API der Komponente auf die REST-API zu.

Methode	Öffentlich / Privat	Beschreibung
GetCurrencyPairs	Öffentlich	Ruft Informationen über verfügbare Währungspaare ab.
GetTickers	Öffentlich	Ruft Ticker-Informationen für ein oder alle Währungspaare ab.
GetOrderBook	Öffentlich	Ruft das Orderbook für ein Währungspaar ab.
GetCandlesticks	Öffentlich	Ruft Candlestick-/Kline-Daten für ein Währungspaar ab.
GetTrades	Öffentlich	Die jüngsten Trades für ein Währungspaar abrufen.
PlaceOrder	Private	Platziert eine neue Order. Unterstützt Limit- und Market-Orders.
CancelOrder	Private	Storniert eine vorhandene Order.
GetOrder	Private	Details einer bestimmten Order abrufen.
GetOpenOrders	Private	Die Liste der offenen Orders abrufen.
GetSpotAccounts	Private	Ruft Informationen zum Spot-Konto ab.

Nachfolgend ein Beispiel für die Verwendung der 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');