API GateIO

Gate.io

サポートされている API

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

プロパティ

GateIOChannel プロパティを使用してチャンネルタイプを選択します：

giocSpot: Spot WebSocket APIに接続します。
giocFutures: 先物 WebSocket API に接続します。

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

ApiKey: Gate.ioアカウントで新しいapiキーをリクエストできます。値をこのプロパティにコピーするだけです。APIKeyが設定されている場合、クライアントはプライベートサーバーに対して認証します。空の場合、パブリックチャンネルのみが利用可能になります。
ApiSecret: API のシークレット値です。
Resubscribe: 有効にすると、再接続後にクライアントは切断前にアクティブだったチャンネルを自動的に再度購読します（デフォルトはfalse）。

接続

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


oClient := TsgcWebSocketClient.Create(nil);
oGateIO := TsgcWS_API_GateIO.Create(nil);
oGateIO.Client := oClient;
oGateIO.GateIO.ApiKey := 'your_api_key';
oGateIO.GateIO.ApiSecret := 'your_api_secret';
oGateIO.GateIOChannel := giocSpot;
oClient.Active := True;
procedure OnConnect(Connection: TsgcWSConnection);
begin
  DoLog('#GateIO Connected');
end;

イベント

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

OnConnect: WebSocket クライアントが WebSocket サーバーに接続したときに発生します。
OnDisconnect: WebSocket クライアントが WebSocket サーバーから切断されたときに発生します。
OnGateIOAuthentication: クライアントがプライベートWebSocketサーバーに対して認証するときに発生します。
OnGateIOSubscribe: クライアントが WebSocket チャンネルをサブスクライブしたとき。
OnGateIOUnSubscribe: クライアントが WebSocket チャンネルからサブスクライブ解除したとき。
OnGateIOData: クライアントがサーバーからデータを受信したとき。
OnGateIOError: GateIO WebSocket 接続中にエラーが発生した場合。
OnGateIOHTTPException: RESTリクエスト中にエラーが発生した場合。

WebSocket API

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

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

メソッド	パブリックまたはプライベート	説明
SubscribeTicker	パブリック	銘柄のティッカーストリームをサブスクライブします。
SubscribeTrades	パブリック	最新の取引ストリームにサブスクライブします。
SubscribeCandlesticks	パブリック	ローソク足ストリームをサブスクライブします。複数のインターバル（例: 1m、5m、15m、30m、1h）に対応しています。
SubscribeOrderBook	パブリック	注文板ストリームをサブスクライブします。設定可能な深さレベルと更新間隔をサポートします。
SubscribeOrders	プライベート	注文の更新をサブスクライブします。認証が必要です。
SubscribeBalances	プライベート	残高更新をサブスクライブします。認証が必要です。

パブリック WebSocket チャネルのサブスクライブ例を以下に示します。


procedure OnConnect(Connection: TsgcWSConnection);
begin
  oGateIO.SubscribeTicker('BTC_USDT');
  oGateIO.SubscribeOrderBook('BTC_USDT', '20', '100ms');
end;

REST API

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

メソッド	パブリック / プライベート	説明
GetCurrencyPairs	パブリック	利用可能な通貨ペアの情報を取得します。
GetTickers	パブリック	1 つまたはすべての通貨ペアのティッカー情報を取得します。
GetOrderBook	パブリック	通貨ペアの注文板を取得します。
GetCandlesticks	パブリック	通貨ペアのローソク足/K ラインデータを取得します。
GetTrades	パブリック	通貨ペアの最新取引を取得します。
PlaceOrder	プライベート	新規注文を発注します。指値注文と成行注文をサポートします。
CancelOrder	プライベート	既存の注文をキャンセルします。
GetOrder	プライベート	特定の注文の詳細を取得します。
GetOpenOrders	プライベート	未決注文のリストを取得します。
GetSpotAccounts	プライベート	スポットアカウント情報を取得します。

以下に REST API の使用例を示します。


oGateIO := TsgcWS_API_GateIO.Create(nil);
oGateIO.GateIO.ApiKey := 'your_api_key';
oGateIO.GateIO.ApiSecret := 'your_api_secret';
// Get tickers
oGateIO.REST_API.GetTickers('BTC_USDT');
// Place an order
oGateIO.REST_API.PlaceOrder('BTC_USDT', 'buy', '0.001', '50000', 'limit');