API Bitget

Bitget

API supportate

• WebSocket API: connette a un server websocket e fornisce aggiornamenti in tempo reale dei dati di mercato, variazioni dell'account e altro.
• REST API: invia richieste HTTP per ottenere dati di mercato, piazzare ordini, dati dell'account...

Proprietà

Utilizzare la proprietà BitgetChannel per selezionare il tipo di canale:

• bgcSpot: connette all'API WebSocket Spot.
• bgcFutures: connettiti all'API WebSocket Futures.

Può configurare le seguenti proprietà nella proprietà Bitget.

• ApiKey: può richiedere una nuova chiave api nel suo account Bitget, basta copiare il valore in questa proprietà. Se l'APIKey è impostata, il client si connetterà al server privato websocket. Se è vuota, si connetterà al server pubblico WebSocket.
• ApiSecret: è il valore segreto dell'api.
• Passphrase: è la stringa personalizzata definita durante la creazione di una nuova chiave API.
• Resubscribe: se abilitato, dopo una riconnessione il client si iscrive di nuovo automaticamente ai canali che erano attivi prima della disconnessione (per impostazione predefinita false).

Connessione

Quando il client si connette con successo ai server Bitget, viene generato l'evento OnConnect. Dopo che l'evento OnConnect è stato generato, è possibile iniziare a inviare e ricevere messaggi da/verso i server Bitget. Se ci si connette al canale WebSocket privato, è necessario attendere che l'evento OnBitgetAuthentication venga generato e verificare che il parametro success sia true, prima di sottoscrivere qualsiasi canale.

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;

Eventi

Il client Bitget implementa i seguenti eventi per controllare il flusso di connessione e ottenere i dati inviati dal server WebSocket:

• OnConnect: attivato quando il client websocket si connette al server WebSocket.
• OnDisconnect: attivato quando il client websocket si disconnette dal WebSocket Server.
• OnBitgetAuthentication: attivato quando il client si autentica sul Private WebSocket Server.
• OnBitgetSubscribe: quando il client si sottoscrive a un canale websocket.
• OnBitgetUnSubscribe: quando il client annulla la sottoscrizione a un canale websocket.
• OnBitgetData: quando il client riceve dati dal server.
• OnBitgetError: quando si verifica un errore durante la connessione websocket Bitget.
• OnBitgetHTTPException: viene generato quando si verifica un errore durante la richiesta REST.

WebSocket API

Il feed websocket fornisce aggiornamenti in tempo reale sui dati di mercato per ordini e transazioni.

Può sottoscrivere i seguenti canali:

Method	Pubblico o Privato	Description
SubscribeTicker	Public	Sottoscrive lo stream ticker per uno strumento.
SubscribeTrade	Public	Sottoscrivi allo stream degli scambi recenti.
SubscribeCandle	Public	Sottoscrivi al flusso candlestick. Supporta più intervalli (es. candle1m, candle5m, candle1H).
SubscribeOrderBook	Public	Sottoscrivi al flusso dell'order book. Supporta diversi livelli di profondità.
SubscribeOrders	Privato	Sottoscrivi agli aggiornamenti degli ordini. Richiede autenticazione.
SubscribePositions	Privato	Sottoscrivi agli aggiornamenti delle posizioni. Richiede autenticazione.
SubscribeAccount	Privato	Sottoscrive gli aggiornamenti del saldo dell'account. Richiede l'autenticazione.

Di seguito è riportato un esempio di sottoscrizione ai canali WebSocket privati dopo un'autenticazione riuscita.

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 REST API fornisce metodi pubblici e privati per richiedere dati dai mercati e dagli account privati. Acceda alla REST API tramite la proprietà REST_API del componente.

Method	Public / Private	Description
GetServerTime	Public	Ottiene l'ora del server.
GetTickers	Public	Ottieni informazioni sul ticker per uno o tutti i simboli.
GetOrderBook	Public	Ottieni il book degli ordini per un simbolo.
GetCandles	Public	Recupera i dati candlestick/kline per un simbolo.
GetRecentTrades	Public	Ottiene le operazioni più recenti per un symbol.
PlaceOrder	Privato	Inserire un nuovo ordine.
CancelOrder	Privato	Annulla un ordine esistente.
GetOpenOrders	Privato	Ottenere l'elenco degli ordini aperti.
GetOrderDetail	Privato	Ottiene i dettagli di un ordine specifico.
GetOrderHistory	Privato	Recupera la cronologia degli ordini.
GetAccountAssets	Privato	Ottieni informazioni sulle risorse dell'account.
GetAccountInfo	Privato	Recupera le informazioni sull'account.

Di seguito è riportato un esempio di utilizzo della 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');