API Bybit

Bybit

 

Ondersteunde API's

• WebSocket API: maak verbinding met een websocket-server en biedt realtime marktgegevensupdates, accountwijzigingen en meer.
• REST API: stuur HTTP-verzoeken om marktgegevens op te halen, orders te plaatsen, accountgegevens...

 

Momenteel is de ondersteunde API-versie V5. De V5 API brengt uniformiteit en efficiëntie naar de productlijnen van Bybit en verenigt Spot, Derivaten en Opties in één set specificaties.

 

OpenAPI-versie	Accounttype	Lineair			Omgekeerd		Spot	Opties
		USDT Perpetual	USDC Perpetual	USDC Futures	Perpetueel	Futures
V5	Unified trading-account	✓	✓	✓	zie opmerking		✓	✓
	Klassiek account	✓			✓	✓	✓
V3	Unified trading-account	✓	✓					✓
	Klassiek account	✓			✓	✓	✓

 

*Opmerking: het Unified-account ondersteunt inverse handel. De gebruikte marge is echter afkomstig uit de inverse derivaten-wallet in plaats van de unified wallet.

 

Eigenschappen

U kunt de volgende eigenschappen configureren in de Bybit-eigenschap.

 

• ApiKey: u kunt een nieuwe API-sleutel aanvragen in uw Bybit-account; kopieer de waarde gewoon naar deze eigenschap. Als de APIKey is ingesteld, maakt de client verbinding met de private WebSocket-server. Als deze leeg is, maakt de client verbinding met de openbare WebSocket-server.
• ApiSecret: het is de geheime waarde van de API.
• SignatureExpires: aantal seconden waarna de handtekening verloopt (standaard 10 seconden).

• TestNet: als ingeschakeld, maakt verbinding met het Bybit TestNet Demo-account (standaard uitgeschakeld).

 

Verbinding

Wanneer de client succesvol verbinding maakt met de Bybit-servers, wordt de gebeurtenis OnConnect geactiveerd. Na het activeren van de gebeurtenis OnConnect kunt u beginnen met het verzenden en ontvangen van berichten van/naar Bybit-servers. Als u verbinding maakt met het privé-websocketkanaal, moet u wachten totdat de gebeurtenis OnBybitAuthentication wordt geactiveerd en controleren of de parameter success true is, voordat u zich op een kanaal abonneert.

 

De client ondersteunt meerdere API's; gebruik de eigenschap BybitClient om in te stellen welke API u wilt gebruiken:

 

• bybSpot
• bybInverse
• bybLinear
• bybPerpetual

 

Hieronder vindt u een voorbeeld van het verbinden met de WebSocket Spot Private API.

oClient := TsgcWebSocketClient.Create(nil);
oBybit := TsgcWSAPI_Bybit.Create(nil);
oBybit.Client := oClient;
oBybit.Bybit.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oBybit.Bybit.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oBybit.BybitClient := bybSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#Bybit Connected');
end;

Na een succesvolle verbinding met de Spot WebSocket-server kunt u beginnen met abonneren op WebSocket-kanalen; ga naar de eigenschap SPOT en roep vervolgens een van de beschikbare abonneer-/afmeldmethoden aan.

 

Gebeurtenissen

De bybit-client implementeert de volgende evenementen om de verbindingsstroom te beheren en gegevens te ontvangen die zijn verzonden vanuit de WebSocket-server:

 

• OnConnect: geactiveerd wanneer de websocket-client verbinding maakt met de WebSocket-server.
• OnDisconnect: gegenereerd wanneer de WebSocket-client de verbinding verbreekt met de WebSocket-server.
• OnBybitAuthentication: fired when de client authenticates against the Privé WebSocket Server.
• OnBybitSubscribe: wanneer de client zich abonneert op een websocket-kanaal.
• OnBybitUnSubscribe: wanneer de client zich afmeldt van een WebSocket-kanaal.
• OnBybitData: wanneer de client gegevens ontvangt van de server.
• OnBybitError: wanneer er een fout optreedt tijdens de bybit websocket-verbinding.
• OnBybitHTTPException: wanneer er een fout optreedt tijdens het REST-verzoek.

 

WebSocket API

De websocket-feed biedt realtime updates van marktgegevens voor orders en trades. De websocket-feed heeft enkele openbare kanalen zoals ticker, trades...

 

U kunt zich abonneren op de volgende kanalen:

 

Methode	Openbaar or Privé	Beschrijving
SubscribeOrderBook	Publiek	Abonneer op de orderboekstroom. Ondersteunt verschillende diepten.
SubscribeTrade	Publiek	Abonneer u op de stream van recente handel.
SubscribeTicker	Publiek	Abonneren op de tickerstream.
SubscribeKLine	Publiek	Abonneer op de klines-stream.
SubscribeLiquidation	Publiek	Abonneer op de liquidatiestream
SubscribeLT_KLine	Publiek	Abonneer u op de gestuurde token kline-stream.
SubscribeLT_Ticker	Publiek	Abonneer op de leveraged token ticker-stream.
SubscribeLT_Nav	Publiek	Abonneer op de leveraged token ticker-stream.
SubscribePosition	Privé	Abonneer op de leveraged token nav-stroom.
SubscribeExecution	Privé	Abonneren
SubscribeOrder	Privé	Abonneren
SubscribeWallet	Privé	Abonneren
SubscribeGreek	Privé	Abonneren
SubscribeDcp	Privé	Abonneren
SubscribeInsurance	Publiek	Subscribe to the insurance fund stream.
SubscribeOrderPriceLimit	Publiek	Subscribe to the order price limit stream.
SubscribeADLAlert	Publiek	Abonneer op de auto-deleverage-waarschuwingsstream.
SubscribeFastExecution	Privé	Abonneren op de snelle uitvoeringsstroom.

 

Hieronder vindt u een voorbeeld van het abonneren op privé-websocketkanalen na een succesvolle authenticatie.

oClient := TsgcWebSocketClient.Create(nil);
oBybit := TsgcWSAPI_Bybit.Create(nil);
oBybit.Client := oClient;
oBybit.Bybit.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oBybit.Bybit.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oBybit.BybitClient := bybSpot;
oClient.Active := True;
procedure OnBybitAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string)
begin
  if aSuccess then
  begin
    oClient.SubscribeOrderBook('BTCUSDT');
    oClient.SubscribeTrade('BTCUSDT');
  end;
end;

REST API

De REST API heeft een lijst van publieke en private methoden om gegevens op te vragen van: markten, private accounts en wallets. Hieronder vindt u een lijst van beschikbare methoden.

 

Methode	Publiek / Privé
GetServerTime	Publiek
GetKLine	Publiek
GetMarkPriceKLine	Publiek
GetIndexPriceKLine	Publiek
GetPremiumIndexPriceKLine	Publiek
GetInstrumentsInfo	Publiek
GetOrderBook	Publiek
GetTickers	Publiek
GetFundingRateHistory	Publiek
GetPublicRecentTradingHistory	Publiek
GetOpenInterest	Publiek
GetHistoricalVolatility	Publiek
GetInsurance	Publiek
GetRiskLimit	Publiek
GetDeliveryPrice	Publiek
GetLongShortRatio	Publiek
PlaceOrder	Privé
PlaceMarketOrder	Privé
PlaceLimitOrder	Privé
AmendOrder	Privé
CancelOrder	Privé
GetOpenOrders	Privé
CancelAllOrders	Privé
GetOrderHistory	Privé
GetPositionInfo	Privé
SetLeverage	Privé
SwitchCrossIsolatedMargin	Privé
SetTPSLMode	Privé
SwitchPositionMode	Privé
SetRiskLimit	Privé
SetTradingStop	Privé
SetAutoAddMargin	Privé
AddOrReduceMargin	Privé
GetExecution	Privé
GetClosedPNL	Privé
ConfirmNewRiskLimit	Privé
GetWalletBalance	Privé
GetAccountInfo	Privé
GetTransactionLog	Privé
BatchPlaceOrder	Privé
BatchAmendOrder	Privé
BatchCancelOrder	Privé
SetDCP	Privé
GetFeeRate	Privé
GetCollateralInfo	Privé
SetMarginMode	Privé
GetBorrowHistory	Privé
GetCoinGreeks	Privé
GetCoinInfo	Privé
GetAllCoinsBalance	Privé
CreateInternalTransfer	Privé
GetInternalTransferList	Privé
GetDepositRecords	Privé
GetDepositAddress	Privé
CreateWithdrawal	Privé
CancelWithdrawal	Privé
GetWithdrawalRecords	Privé

 

Hieronder vindt u een voorbeeld van het ophalen van de openstaande orders.

oClient := TsgcWebSocketClient.Create(nil);
oBybit := TsgcWSAPI_Bybit.Create(nil);
oBybit.Client := oClient;
oBybit.Bybit.ApiKey := 'alsdjk23kandfnasbdfdkjhsdf';
oBybit.Bybit.ApiSecret := 'aldskjfk3jkadknfajndsjfj23j';
oBybit.BybitClient := bybSpot;
oBybit.REST_API.GetAccountInfo();