API GateIO

Gate.io

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

• giocSpot: maak verbinding met de Spot WebSocket API.
• giocFutures: maak verbinding met de Futures WebSocket API.

U kunt de volgende eigenschappen configureren in de eigenschap GateIO.

• ApiKey: u kunt een nieuwe api-sleutel aanvragen in uw Gate.io-account; kopieer gewoon de waarde naar deze eigenschap. Als de APIKey is ingesteld, verifieert de client zich bij de privéserver. Als deze leeg is, zijn alleen openbare kanalen beschikbaar.
• 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 succesvol verbinding maakt met Gate.io-servers, wordt de gebeurtenis OnConnect gegenereerd. Nadat de gebeurtenis OnConnect is gegenereerd, kunt u beginnen met het verzenden en ontvangen van berichten naar/van Gate.io-servers. Als u verbinding maakt met het privé WebSocket-kanaal, moet u wachten totdat de gebeurtenis OnGateIOAuthentication is gegenereerd en controleren of de parameter success true is, voordat u zich abonneert op een privékanaal.

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;

Gebeurtenissen

De GateIO-client implementeert de volgende gebeurtenissen om de verbindingsstroom te controleren 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.
• OnGateIOAuthentication: wordt geactiveerd wanneer de client zich authenticeert bij de privé-WebSocket-server.
• OnGateIOSubscribe: wanneer de client zich abonneert op een WebSocket-kanaal.
• OnGateIOUnSubscribe: wanneer de client zich afmeldt van een WebSocket-kanaal.
• OnGateIOData: wanneer de client gegevens van de server ontvangt.
• OnGateIOError: wanneer er een fout optreedt tijdens de GateIO WebSocket-verbinding.
• OnGateIOHTTPException: 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 kanalen:

Methode	Openbaar or Privé	Beschrijving
SubscribeTicker	Publiek	Abonneer u op de tickerstream voor een symbool.
SubscribeTrades	Publiek	Abonneer u op de stream van recente handel.
SubscribeCandlesticks	Publiek	Abonneer u op de candlestick-stream. Ondersteunt meerdere intervallen (bijv. 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Publiek	Abonneer op de orderboekstream. Ondersteunt configureerbare diepteniveaus en update-intervallen.
SubscribeOrders	Privé	Abonneren op orderupdates. Vereist authenticatie.
SubscribeBalances	Privé	Abonneer op saldo-updates. Vereist authenticatie.

Hieronder vindt u een voorbeeld van het abonneren op openbare websocket-kanalen.

procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
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
GetCurrencyPairs	Publiek	Informatie ophalen over beschikbare valutaparen.
GetTickers	Publiek	Haal tickerinformatie op voor één of alle valutaparen.
GetOrderBook	Publiek	Haal het orderboek op voor een valutapaar.
GetCandlesticks	Publiek	Haal candlestick/kline-gegevens op voor een valutapaar.
GetTrades	Publiek	Haal de meest recente handel voor een valutapaar op.
PlaceOrder	Privé	Plaats een nieuwe order. Ondersteunt limiet- en marktorders.
CancelOrder	Privé	Cancel an existing order.
GetOrder	Privé	Details van een specifieke order ophalen.
GetOpenOrders	Privé	Haal de lijst met openstaande orders op.
GetSpotAccounts	Privé	Accountinformatie voor spot ophalen.

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