API GateIO

Gate.io

APIs admitidas

• WebSocket API: conéctese a un servidor websocket y obtenga actualizaciones de datos de mercado en tiempo real, cambios de cuenta y más.
• REST API: envíe solicitudes HTTP para obtener datos de mercado, colocar órdenes, datos de cuenta...

Propiedades

Utilice la propiedad GateIOChannel para seleccionar el tipo de canal:

• giocSpot: conectar a la API WebSocket Spot.
• giocFutures: conectarse a la API WebSocket de Futuros.

Puede configurar las siguientes propiedades en la propiedad GateIO.

• ApiKey: puede solicitar una nueva clave de API en su cuenta de Gate.io; simplemente copie el valor en esta propiedad. Si se establece el APIKey, el cliente se autenticará contra el servidor privado. Si está vacío, solo estarán disponibles los canales públicos.
• ApiSecret: es el valor secreto de la api.
• Resubscribe: si está habilitado, tras una reconexión el cliente se suscribe de nuevo automáticamente a los canales que estaban activos antes de la desconexión (por defecto false).

Conexión

Cuando el cliente se conecta correctamente a los servidores de Gate.io, se activa el evento OnConnect. Tras la activación del evento OnConnect, puede comenzar a enviar y recibir mensajes hacia/desde los servidores de Gate.io. Si se está conectando al canal privado de websocket, debe esperar hasta que se active el evento OnGateIOAuthentication y comprobar que el parámetro success es true antes de suscribirse a cualquier canal privado.

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;

Eventos

El cliente de GateIO implementa los siguientes eventos para controlar el flujo de conexión y obtener los datos enviados desde el servidor WebSocket:

• OnConnect: se activa cuando el cliente websocket se conecta al servidor WebSocket.
• OnDisconnect: se dispara cuando el cliente WebSocket se desconecta del servidor WebSocket.
• OnGateIOAuthentication: se activa cuando el cliente se autentica contra el servidor WebSocket privado.
• OnGateIOSubscribe: cuando el cliente se suscribe a un canal de websocket.
• OnGateIOUnSubscribe: cuando el cliente cancela la suscripción a un canal websocket.
• OnGateIOData: cuando el cliente recibe datos del servidor.
• OnGateIOError: cuando se produce algún error durante la conexión websocket de GateIO.
• OnGateIOHTTPException: cuando se produce algún error durante la solicitud REST.

WebSocket API

El feed WebSocket proporciona actualizaciones de datos de mercado en tiempo real para órdenes y operaciones.

Puede suscribirse a los siguientes canales:

Método	Público o Privado	Descripción
SubscribeTicker	Público	Suscríbase al flujo de ticker para un símbolo.
SubscribeTrades	Público	Suscribirse al flujo de operaciones recientes.
SubscribeCandlesticks	Público	Suscribirse al stream de velas. Admite múltiples intervalos (por ejemplo, 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Público	Suscríbase al flujo del libro de órdenes. Admite niveles de profundidad e intervalos de actualización configurables.
SubscribeOrders	Privado	Suscribirse a actualizaciones de órdenes. Requiere autenticación.
SubscribeBalances	Privado	Suscribirse a actualizaciones de saldo. Requiere autenticación.

A continuación encontrará un ejemplo de suscripción a canales WebSocket públicos.

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

REST API

La API REST proporciona métodos públicos y privados para solicitar datos de mercados y cuentas privadas. Acceda a la API REST a través de la propiedad REST_API del componente.

Método	Público / Privado	Descripción
GetCurrencyPairs	Público	Obtener información sobre los pares de divisas disponibles.
GetTickers	Público	Obtiene información de ticker para uno o todos los pares de divisas.
GetOrderBook	Público	Obtiene el libro de órdenes para un par de divisas.
GetCandlesticks	Público	Obtener datos de velas/kline para un par de divisas.
GetTrades	Público	Obtiene las operaciones más recientes de un par de divisas.
PlaceOrder	Privado	Coloca una nueva orden. Admite órdenes limitadas y de mercado.
CancelOrder	Privado	Cancela una orden existente.
GetOrder	Privado	Obtener detalles de un pedido específico.
GetOpenOrders	Privado	Obtener la lista de órdenes abiertas.
GetSpotAccounts	Privado	Obtener información de la cuenta spot.

A continuación se muestra un ejemplo del uso de la 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');