API Bitget

Bitget

サポートされている API

WebSocket API: WebSocket サーバーに接続し、リアルタイムの市場データ更新、アカウント変更などを提供します。
REST API: HTTPリクエストを送信して、市場データの取得、注文の発注、アカウントデータの取得などを行います。

プロパティ

チャンネルタイプを選択するには BitgetChannel プロパティを使用してください:

bgcSpot: Spot WebSocket API に接続します。
bgcFutures: Futures WebSocket APIに接続します。

Bitget プロパティで以下のプロパティを設定できます。

ApiKey: Bitget アカウントで新しい API キーをリクエストし、その値をこのプロパティにコピーしてください。APIKey が設定されている場合、クライアントは WebSocket プライベートサーバーに接続します。空の場合は WebSocket パブリックサーバーに接続します。
ApiSecret: API のシークレット値です。
Passphrase: 新しい API キーを作成するときに定義するカスタム文字列です。
Resubscribe: 有効にすると、再接続後にクライアントは切断前にアクティブだったチャンネルを自動的に再度購読します（デフォルトはfalse）。

接続

クライアントがBitgetサーバーに正常に接続すると、OnConnect イベントが発生します。OnConnect イベントが発生した後、Bitgetサーバーとのメッセージの送信および受信を開始できます。プライベートWebSocketチャンネルに接続する場合は、いずれかのチャンネルにサブスクライブする前に、OnBitgetAuthentication イベントが発生するまで待機し、successパラメータがtrueかどうかを確認する必要があります。


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;

イベント

Bitget クライアントは、接続フローを制御し WebSocket サーバーから送信されたデータを取得するための以下のイベントを実装しています。

OnConnect: WebSocket クライアントが WebSocket サーバーに接続したときに発生します。
OnDisconnect: WebSocket クライアントが WebSocket サーバーから切断されたときに発生します。
OnBitgetAuthentication: クライアントがプライベート WebSocket サーバーに対して認証を行ったときに発生します。
OnBitgetSubscribe： クライアントが WebSocket チャネルをサブスクライブしたとき。
OnBitgetUnSubscribe:クライアントがWebSocketチャンネルのサブスクリプションを解除したとき。
OnBitgetData: クライアントがサーバーからデータを受信したとき。
OnBitgetError: Bitget WebSocket 接続中にエラーが発生したとき。
OnBitgetHTTPException: REST リクエスト中にエラーが発生した場合。

WebSocket API

WebSocket フィードは注文と取引のリアルタイムの市場データ更新を提供します。

以下のチャンネルにサブスクライブできます:

メソッド	パブリックまたはプライベート	説明
SubscribeTicker	パブリック	インストルメントのティッカーストリームにサブスクライブします。
SubscribeTrade	パブリック	最新の取引ストリームにサブスクライブします。
SubscribeCandle	パブリック	ローソク足ストリームにサブスクライブします。複数の時間間隔をサポートします（例: candle1m、candle5m、candle1H）。
SubscribeOrderBook	パブリック	オーダーブックストリームをサブスクライブします。異なる深度レベルをサポートします。
SubscribeOrders	プライベート	注文の更新をサブスクライブします。認証が必要です。
SubscribePositions	プライベート	ポジション更新をサブスクライブします。認証が必要です。
SubscribeAccount	プライベート	アカウント残高の更新をサブスクライブします。認証が必要です。

認証成功後にプライベート WebSocket チャンネルをサブスクライブする例を以下に示します。


procedure OnBitgetAuthentication(Sender: TObject; aSuccess: Boolean; const aError, aRawMessage: string);
begin
  if aSuccess then
  begin
    oBitget.SubscribeOrders('BTCUSDT');
    oBitget.SubscribeAccount();
  end;
end;

REST API

REST API は市場とプライベートアカウントからデータをリクエストするためのパブリックとプライベートのメソッドを提供します。コンポーネントの REST_API プロパティを通じて REST API にアクセスします。

メソッド	パブリック / プライベート	説明
GetServerTime	パブリック	サーバー時刻を取得します。
GetTickers	パブリック	1 つまたはすべてのシンボルのティッカー情報を取得します。
GetOrderBook	パブリック	シンボルの注文書を取得します。
GetCandles	パブリック	シンボルのローソク足/Kline データを取得します。
GetRecentTrades	パブリック	銘柄の直近の取引を取得します。
PlaceOrder	プライベート	新しい注文を発注します。
CancelOrder	プライベート	既存の注文をキャンセルします。
GetOpenOrders	プライベート	未決注文のリストを取得します。
GetOrderDetail	プライベート	特定の注文の詳細を取得します。
GetOrderHistory	プライベート	注文履歴を取得します。
GetAccountAssets	プライベート	口座資産情報を取得します。
GetAccountInfo	プライベート	アカウント情報を取得します。

以下に 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');