API GateIO

Gate.io

APIs suportadas

• WebSocket API: conecta a um servidor websocket e fornece atualizações de dados de mercado em tempo real, alterações de conta e muito mais.
• REST API: envia requisições HTTP para obter dados de mercado, registrar ordens, dados de conta...

Properties

Utilize a propriedade GateIOChannel para selecionar o tipo de canal:

• giocSpot: conecta à Spot WebSocket API.
• giocFutures: conecta-se à Futures WebSocket API.

Você pode configurar as seguintes propriedades na propriedade GateIO.

• ApiKey: você pode requisitar uma nova api key em sua conta da Gate.io; basta copiar o valor para esta propriedade. Se a APIKey for definida, o cliente se autenticará contra o servidor privado. Se estiver vazia, apenas canais públicos estarão disponíveis.
• ApiSecret: é o valor secreto da api.
• Resubscribe: se habilitado, após uma reconexão o cliente se inscreve automaticamente de novo nos canais que estavam ativos antes da desconexão (por padrão false).

Conexão

Quando o cliente se conecta com sucesso aos servidores da Gate.io, o evento OnConnect é disparado. Após o evento OnConnect ser disparado, você pode começar a enviar e receber mensagens de/para os servidores da Gate.io. Se você estiver se conectando ao canal websocket privado, deve aguardar até que o evento OnGateIOAuthentication seja disparado e verificar se o parâmetro success é true, antes de assinar qualquer 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

O cliente GateIO implementa os seguintes eventos para controlar o fluxo da conexão e obter os dados enviados pelo servidor WebSocket:

• OnConnect: disparado quando o cliente websocket conecta ao Servidor WebSocket.
• OnDisconnect: disparado quando o cliente websocket se desconecta do WebSocket Server.
• OnGateIOAuthentication: disparado quando o cliente se autentica contra o Servidor WebSocket Privado.
• OnGateIOSubscribe: quando o cliente assina um canal websocket.
• OnGateIOUnSubscribe: quando o cliente faz unsubscribe de um canal websocket.
• OnGateIOData: quando o cliente recebe dados do servidor.
• OnGateIOError: quando há algum erro durante a conexão websocket da GateIO.
• OnGateIOHTTPException: quando há qualquer erro durante a requisição REST.

WebSocket API

O feed websocket fornece atualizações de market data em tempo real para ordens e negociações.

Você pode se inscrever nos seguintes canais:

Method	Público ou privado	Descrição
SubscribeTicker	Public	Inscreve-se no stream de ticker de um símbolo.
SubscribeTrades	Public	Assine o stream de trades recentes.
SubscribeCandlesticks	Public	Assine o stream de candlestick. Suporta múltiplos intervalos (por exemplo 1m, 5m, 15m, 30m, 1h).
SubscribeOrderBook	Public	Assina o stream do livro de ordens. Suporta níveis de profundidade configuráveis e intervalos de atualização.
SubscribeOrders	Private	Assina atualizações de ordens. Requer autenticação.
SubscribeBalances	Private	Assinar atualizações de saldo. Requer autenticação.

Veja abaixo um exemplo de assinatura de canais websocket públicos.

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

REST API

A REST API fornece métodos Públicos e Privados para solicitar dados de mercados e de contas privadas. Acesse a REST API através da propriedade REST_API do componente.

Method	Público / Privado	Descrição
GetCurrencyPairs	Public	Obter informações sobre os pares de moedas disponíveis.
GetTickers	Public	Obtém informações de ticker de um ou de todos os pares de moedas.
GetOrderBook	Public	Obter o order book de um par de moedas.
GetCandlesticks	Public	Obtém dados de candlestick/kline para um par de moedas.
GetTrades	Public	Obtém os trades mais recentes de um par de moedas.
PlaceOrder	Private	Coloca uma nova ordem. Suporta ordens limit e market.
CancelOrder	Private	Cancela uma ordem existente.
GetOrder	Private	Obter detalhes de uma ordem específica.
GetOpenOrders	Private	Obter a lista de ordens abertas.
GetSpotAccounts	Private	Obter informações da conta spot.

Encontre abaixo um exemplo de uso da 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');