API Bitget

Bitget

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

Use a propriedade BitgetChannel para selecionar o tipo de canal:

• bgcSpot: conecta à WebSocket API do Spot.
• bgcFutures: conecta à Futures WebSocket API.

Você pode configurar as seguintes propriedades na propriedade Bitget.

• ApiKey: você pode solicitar uma nova chave de api na sua conta Bitget, basta copiar o valor para esta propriedade. Se a APIKey for definida, o cliente se conectará ao servidor websocket privado. Se estiver vazia, conectará ao servidor WebSocket público.
• ApiSecret: é o valor secreto da api.
• Passphrase: é a string personalizada definida ao criar uma nova api key.
• 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 Bitget, 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 Bitget. Se você estiver se conectando ao canal websocket privado, deve aguardar até que o evento OnBitgetAuthentication seja disparado e verificar se o parâmetro success é true, antes de assinar qualquer canal.

oClient := TsgcWebSocketClient.Create(nil);
oBitget := TsgcWS_API_Bitget.Create(nil);
oBitget.Client := oClient;
oBitget.Bitget.ApiKey := 'your_api_key';
oBitget.Bitget.ApiSecret := 'your_api_secret';
oBitget.Bitget.Passphrase := 'your_passphrase';
oBitget.BitgetChannel := bgcSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#Bitget Connected');
end;

Eventos

O cliente Bitget implementa os seguintes eventos para controlar o fluxo de 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.
• OnBitgetAuthentication: disparado quando o cliente se autentica contra o Servidor WebSocket Privado.
• OnBitgetSubscribe: quando o cliente assina um canal websocket.
• OnBitgetUnSubscribe: quando o cliente cancela a assinatura de um canal websocket.
• OnBitgetData: quando o cliente recebe dados do servidor.
• OnBitgetError: quando há algum erro durante a conexão websocket da Bitget.
• OnBitgetHTTPException: quando há algum 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	Assine o stream de ticker para um instrumento.
SubscribeTrade	Public	Assine o stream de trades recentes.
SubscribeCandle	Public	Assine o stream de candlestick. Suporta múltiplos intervalos (por exemplo candle1m, candle5m, candle1H).
SubscribeOrderBook	Public	Assina o stream do order book. Suporta diferentes níveis de profundidade.
SubscribeOrders	Private	Assina atualizações de ordens. Requer autenticação.
SubscribePositions	Private	Assina atualizações de posição. Requer autenticação.
SubscribeAccount	Private	Assinar atualizações de saldo da conta. Requer autenticação.

Veja abaixo um exemplo de assinatura de canais websocket privados após uma autenticação bem-sucedida.

procedure OnBitgetAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string);
begin
  if aSuccess then
  begin
    oBitget.SubscribeOrders('BTCUSDT');
    oBitget.SubscribeAccount();
  end;
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
GetServerTime	Public	Obter o horário do servidor.
GetTickers	Public	Obtém informações de ticker para um ou todos os símbolos.
GetOrderBook	Public	Obtém o livro de ordens de um símbolo.
GetCandles	Public	Obtém dados de candlestick/kline para um símbolo.
GetRecentTrades	Public	Obter as negociações mais recentes de um símbolo.
PlaceOrder	Private	Coloca uma nova ordem.
CancelOrder	Private	Cancela uma ordem existente.
GetOpenOrders	Private	Obter a lista de ordens abertas.
GetOrderDetail	Private	Obter detalhes de uma ordem específica.
GetOrderHistory	Private	Obtém o histórico de ordens.
GetAccountAssets	Private	Obtém as informações de ativos da conta.
GetAccountInfo	Private	Obtém as informações da conta.

Encontre abaixo um exemplo de uso da REST API.

oBitget := TsgcWS_API_Bitget.Create(nil);
oBitget.Bitget.ApiKey := 'your_api_key';
oBitget.Bitget.ApiSecret := 'your_api_secret';
oBitget.Bitget.Passphrase := 'your_passphrase';
// Get tickers
oBitget.REST_API.GetTickers('SPOT');
// Place an order
oBitget.REST_API.PlaceOrder('BTCUSDT', 'buy', 'market', 'normal', '0.01');