API Bitget

Bitget

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

Use la propiedad BitgetChannel para seleccionar el tipo de canal:

• bgcSpot: conectarse a la API WebSocket Spot.
• bgcFutures: conecta con la API WebSocket de Futuros.

Puede configurar las siguientes propiedades en la propiedad Bitget.

• ApiKey: puede solicitar una nueva clave de API en su cuenta de Bitget; simplemente copie el valor en esta propiedad. Si se establece el APIKey, el cliente se conectará al servidor websocket privado. Si está vacío, se conectará al servidor WebSocket público.
• ApiSecret: es el valor secreto de la api.
• Passphrase: es la cadena personalizada definida al crear una nueva clave de 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 Bitget, se activa el evento OnConnect . Una vez activado el evento OnConnect , puede comenzar a enviar y recibir mensajes hacia/desde los servidores de Bitget. Si se conecta al canal WebSocket privado, debe esperar a que se active el evento OnBitgetAuthentication y comprobar que el parámetro success es true antes de suscribirse a cualquier 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

El cliente Bitget 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.
• OnBitgetAuthentication: se dispara cuando el cliente se autentica contra el servidor WebSocket privado.
• OnBitgetSubscribe: cuando el cliente se suscribe a un canal websocket.
• OnBitgetUnSubscribe: cuando el cliente cancela la suscripción de un canal websocket.
• OnBitgetData: cuando el cliente recibe datos del servidor.
• OnBitgetError: cuando se produce algún error durante la conexión websocket de Bitget.
• OnBitgetHTTPException: 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	Suscribirse al flujo del ticker para un instrumento.
SubscribeTrade	Público	Suscribirse al flujo de operaciones recientes.
SubscribeCandle	Público	Suscríbase al flujo de velas. Admite múltiples intervalos (p. ej. candle1m, candle5m, candle1H).
SubscribeOrderBook	Público	Suscríbase al stream del libro de órdenes. Admite diferentes niveles de profundidad.
SubscribeOrders	Privado	Suscribirse a actualizaciones de órdenes. Requiere autenticación.
SubscribePositions	Privado	Suscribirse a actualizaciones de posición. Requiere autenticación.
SubscribeAccount	Privado	Suscribirse a actualizaciones de saldo de cuenta. Requiere autenticación.

A continuación encontrará un ejemplo de suscripción a canales WebSocket privados tras una autenticación exitosa.

procedure OnBitgetAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string);
begin
  if aSuccess then
  begin
    oBitget.SubscribeOrders('BTCUSDT');
    oBitget.SubscribeAccount();
  end;
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
GetServerTime	Público	Obtener la hora del servidor.
GetTickers	Público	Obtiene información del ticker para uno o todos los símbolos.
GetOrderBook	Público	Obtiene el libro de órdenes de un símbolo.
GetCandles	Público	Obtener datos de velas/kline para un símbolo.
GetRecentTrades	Público	Obtiene las operaciones más recientes de un símbolo.
PlaceOrder	Privado	Realice un nuevo pedido.
CancelOrder	Privado	Cancela una orden existente.
GetOpenOrders	Privado	Obtener la lista de órdenes abiertas.
GetOrderDetail	Privado	Obtener detalles de un pedido específico.
GetOrderHistory	Privado	Obtener el historial de órdenes.
GetAccountAssets	Privado	Obtener información de los activos de la cuenta.
GetAccountInfo	Privado	Obtener información de la cuenta.

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