Kraken API の sgcWebSockets 更新

Kraken スポット・先物 API の Delphi 統合

Kraken は最も長い歴史を持つ信頼性の高い暗号通貨取引所の一つで、スポット市場と先物市場の両方を提供しています。Delphi 向けの TsgcWSAPI_Kraken と TsgcWSAPI_Kraken_Futures コンポーネントは Kraken の WebSocket・REST API への完全なアクセスを提供し、リアルタイム市場データストリーミング・口座管理・注文発注・先物取引を単一のコードベースから実現します。

目次

• 概要
• 設定
• スポット WebSocket API
• スポット REST API
• 先物 WebSocket API
• 先物 REST API
• 完全なコード例
• 注意事項とベストプラクティス

概要

Kraken の API は 2 つの異なるプラットフォームに分かれており、それぞれ専用コンポーネントがあります：

コンポーネント	市場	説明
TsgcWSAPI_Kraken	スポット	WebSocket と REST サポートで Kraken のスポット取引所で暗号通貨を取引します
TsgcWSAPI_Kraken_Futures	先物	レバレッジポジションで無期限・固定満期の先物契約を取引します

両コンポーネントはデュアルチャンネルアプローチを提供します：低レイテンシのリアルタイムデータストリーミング用の WebSocket 接続と、残高照会・注文発注・過去データ取得などのリクエスト/レスポンス操作用の REST エンドポイントです。

設定

スポットと先物の両コンポーネントは、プライベート（認証済み）操作に API 認証情報が必要です。市場データなどのパブリックエンドポイントは認証不要です。

プロパティ	型	説明
Kraken.ApiKey	String	Kraken アカウント設定ページで生成した Kraken API キー
Kraken.ApiSecret	String	プライベートリクエストの署名に使用する Kraken API シークレット

注：API キーは kraken.com > セキュリティ > API で生成してください。アプリケーションが必要とする権限のみを割り当ててください。読み取り専用ダッシュボードの場合は取引・出金権限を完全に無効にしてください。

スポット WebSocket API

スポット WebSocket API は市場データとプライベート口座イベントのリアルタイムストリーミングを提供します。メソッドはパブリックチャンネル（認証不要）とプライベートチャンネル（有効な WebSocket トークンが必要）に分かれています。

パブリックチャネル

メソッド	説明
SubscribeTicker / UnSubscribeTicker	最良気配値・24 時間出来高・価格統計を含むリアルタイムティッカー情報
SubscribeOHLC / UnSubscribeOHLC	設定可能な時間間隔でのリアルタイム OHLC（ローソク足）データ
SubscribeTrade / UnSubscribeTrade	取引所のすべての約定を表示するリアルタイム約定フィード
SubscribeBook / UnSubscribeBook	設定可能な深度での板情報スナップショットと差分更新
SubscribeSpread / UnSubscribeSpread	リアルタイムの最良気配値スプレッド更新
SubscribeAll / UnSubscribeAll	指定ペアのすべてのパブリックチャンネルを一度にサブスクライブまたはサブスクライブ解除します

プライベートチャネル

メソッド	説明
SubscribeOwnTrades / UnSubscribeOwnTrades	自分の約定済み取引のリアルタイムフィード
SubscribeOpenOrders / UnSubscribeOpenOrders	未約定注文のリアルタイム更新（新規・変更・キャンセル・約定）
AddOrder	WebSocket 経由で新規注文を発注します（REST より低レイテンシ）
CancelOrder	WebSocket 経由で既存注文をキャンセルします

// Subscribe to public ticker data for BTC/USD
oKraken.SubscribeTicker('XBT/USD');
// Subscribe to the order book with 10-level depth
oKraken.SubscribeBook('XBT/USD');
// Subscribe to real-time trades
oKraken.SubscribeTrade('ETH/USD');
// Subscribe to private channels (requires API key)
oKraken.SubscribeOwnTrades;
oKraken.SubscribeOpenOrders;

スポット REST API

スポット REST API は TsgcWSAPI_Kraken コンポーネントの REST_API プロパティ経由でアクセスします。市場データ照会・口座管理・取引・資金操作のための包括的なエンドポイントセットを提供します。

パブリック REST メソッド

メソッド	説明
GetServerTime	サーバーの現在時刻を返します（時刻同期に便利）
GetAssets	利用可能なすべての資産とそのプロパティ（小数点・表示名）を一覧表示します
GetAssetPairs	手数料構造と証拠金情報を含む取引可能なすべての資産ペアを一覧表示します
GetTicker	1 つ以上のペアのティッカーデータ（気配値・売気配・最終・出来高・VWAP）を返します
GetOHLC	指定ペアと時間間隔の OHLC ローソク足データを返します
GetOrderBook	指定された深度での指定ペアの現在の板情報を返します
GetTrades	指定ペアの最近の約定を返します
GetSpread	指定ペアの最近のスプレッドデータを返します

プライベート REST メソッド - 口座・取引

メソッド	説明
GetAccountBalance	口座内のすべての資産の残高を返します
GetTradeBalance	取引残高情報（純資産・証拠金・余剰証拠金・損益）を返します
GetOpenOrders	現在未約定のすべての注文を返します
GetClosedOrders	最近クローズされた注文を返します
QueryOrders	トランザクション ID で特定の注文を照会します
GetTradesHistory	取引履歴を返します
QueryTrades	取引 ID で特定の取引を照会します
GetLedgers	台帳エントリー（入金・出金・取引・手数料）を返します
QueryLedgers	ID で特定の台帳エントリーを照会します
GetTradeVolume	30 日間の取引量と手数料ティアを返します
AddOrder	REST 経由で新規注文を発注します
CancelOrder	REST 経由で既存注文をキャンセルします
GetWebSocketsToken	プライベート WebSocket サブスクリプションに必要なトークンを生成します

プライベート REST メソッド - エクスポート・レポート

メソッド	説明
AddExport	データエクスポートをリクエストします（取引または台帳エントリー）
ExportStatus	保留中のエクスポートリクエストのステータスを確認します
RetrieveExport	完了したエクスポートファイルをダウンロードします
RemoveExport	エクスポートレポートを削除します

プライベート REST メソッド - 資金

メソッド	説明
GetDepositMethods	指定資産の利用可能な入金方法を返します
GetDepositAddresses	指定資産と方法の入金アドレスを返します
GetStatusOfRecentDeposits	最近の入金トランザクションのステータスを返します
GetWithdrawalInformation	指定資産の出金詳細（手数料・最小額・上限）を返します
WithdrawFunds	外部アドレスへの出金を開始します
GetStatusOfRecentWithdraws	最近の出金トランザクションのステータスを返します
RequestWithdrawalCancelation	保留中の出金のキャンセルを試みます
RequestWalletTransfer	Kraken ウォレット間で資金を移動します（例：スポットから先物）

// Public REST: Get ticker data
ShowMessage(oKraken.REST_API.GetTicker('XBTUSD'));
// Public REST: Get OHLC data
ShowMessage(oKraken.REST_API.GetOHLC('XBTUSD'));
// Private REST: Get account balance
ShowMessage(oKraken.REST_API.GetAccountBalance);
// Private REST: Get open orders
ShowMessage(oKraken.REST_API.GetOpenOrders);

先物 WebSocket API

TsgcWSAPI_Kraken_Futures コンポーネントは、無期限契約と固定満期先物を含む Kraken の先物市場のリアルタイムストリーミングを提供します。

パブリックチャネル

メソッド	説明
SubscribeTicker / UnSubscribeTicker	マーク価格・インデックス価格・ファンディングレートを含むリアルタイムの先物ティッカーデータ
SubscribeTrade / UnSubscribeTrade	先物市場のリアルタイム約定フィード
SubscribeBook / UnSubscribeBook	先物契約の板情報スナップショットと差分更新
SubscribeHeartBeat / UnSubscribeHeartBeat	定期的なハートビートメッセージによる接続の健全性監視
SubscribeTickerLite / UnSubscribeTickerLite	高頻度監視向けのペイロードを削減した軽量ティッカー

プライベートチャネル

メソッド	説明
SubscribeOpenOrdersVerbose / UnSubscribeOpenOrdersVerbose	完全な注文情報を含む詳細なリアルタイム未約定注文更新
SubscribeOpenPositions / UnSubscribeOpenPositions	未決済先物ポジションのリアルタイム更新
SubscribeAccountLog / UnSubscribeAccountLog	リアルタイムの口座アクティビティログ（ファンディング・清算など）
SubscribeFills / UnSubscribeFills	先物注文のリアルタイム約定通知
SubscribeOpenOrders / UnSubscribeOpenOrders	軽量な未約定注文ステータス更新
SubscribeAccountBalanceAndMargins / UnSubscribeAccountBalanceAndMargins	先物口座のリアルタイム残高・証拠金更新
SubscribeNotifications / UnSubscribeNotifications	口座のシステム通知とアラート

先物 REST API

先物 REST API は TsgcWSAPI_Kraken_Futures の REST_API プロパティ経由でアクセスします。市場データ・注文管理・口座照会・資金移動のエンドポイントを提供します。

パブリック REST メソッド

メソッド	説明
GetFeeSchedules	先物取引の現在の手数料スケジュールを返します
GetHistory	先物契約の過去の市場データを返します
GetInstruments	利用可能なすべての先物銘柄とその契約仕様を一覧表示します
GetTickers	すべての先物契約のティッカーデータを返します

プライベート REST メソッド - 口座・注文

メソッド	説明
GetAccounts	先物口座の残高と証拠金情報を返します
GetFills	先物注文の最近の約定履歴を返します
GetHistoricalExecutions	過去の注文執行を返します
GetHistoricalOrders	過去の注文データを返します
GetHistoricalTriggers	条件付き注文の過去のトリガーイベントを返します
GetOpenPositions	現在未決済のすべての先物ポジションを返します
GetNotifications	口座通知を返します

プライベート REST メソッド - 注文管理

メソッド	説明
SendMarketOrder	現在の最良価格で成行注文を発注します
SendLimitOrder	指定価格で指値注文を発注します
SendStopOrder	指定価格でトリガーされるストップ注文を発注します
SendTakeProfit	利確注文を発注します
CancelAllOrders	すべての未約定先物注文を一度にキャンセルします
CancelOrderByOrderId	Kraken の注文 ID を使用して特定の注文をキャンセルします
CancelOrderByCliOrderId	クライアント注文 ID を使用して特定の注文をキャンセルします
EditOrderByOrderId	Kraken の注文 ID を使用して既存注文を変更します
EditOrderByCliOrderId	クライアント注文 ID を使用して既存注文を変更します

プライベート REST メソッド - 移動・レポート

メソッド	説明
Transfer	先物サブアカウント間で資金を移動します
WalletTransfer	ウォレットタイプ間で移動します
SubAccountTransfer	サブアカウント間で移動します
WithdrawalToSpotWallet	先物ウォレットからスポットウォレットに資金を戻します
GetFeeScheduleVolumes	手数料ティア計算のための出来高を返します
GetAccountLogCSV	口座アクティビティログを CSV ファイルとしてダウンロードします

完全なコード例

以下の例は Kraken スポット API への接続・REST 経由の市場データ取得・口座残高照会・WebSocket 経由のリアルタイムティッカーフィードのサブスクライブを示しています。

var
  oClient: TsgcWebSocketClient;
  oKraken: TsgcWSAPI_Kraken;
begin
  // Create and configure the WebSocket client
  oClient := TsgcWebSocketClient.Create(nil);
  oKraken := TsgcWSAPI_Kraken.Create(nil);
  oKraken.Client := oClient;
  // Configure API credentials for private endpoints
  oKraken.Kraken.ApiKey := 'your_api_key';
  oKraken.Kraken.ApiSecret := 'your_api_secret';
  // Connect to Kraken
  oClient.Active := True;
  // REST: Get ticker data for BTC/USD
  ShowMessage(oKraken.REST_API.GetTicker('XBTUSD'));
  // REST: Get account balance (requires API key)
  ShowMessage(oKraken.REST_API.GetAccountBalance);
  // WebSocket: Subscribe to real-time ticker
  oKraken.SubscribeTicker('XBT/USD');
end;

先物の例

先物コンポーネントのセットアップは同じパターンに従い、代わりに TsgcWSAPI_Kraken_Futures を使用します：

var
  oClient: TsgcWebSocketClient;
  oFutures: TsgcWSAPI_Kraken_Futures;
begin
  oClient := TsgcWebSocketClient.Create(nil);
  oFutures := TsgcWSAPI_Kraken_Futures.Create(nil);
  oFutures.Client := oClient;
  // Configure API credentials
  oFutures.Kraken.ApiKey := 'your_futures_api_key';
  oFutures.Kraken.ApiSecret := 'your_futures_api_secret';
  oClient.Active := True;
  // REST: Get all available futures instruments
  ShowMessage(oFutures.REST_API.GetInstruments);
  // REST: Get account information
  ShowMessage(oFutures.REST_API.GetAccounts);
  // WebSocket: Subscribe to futures ticker
  oFutures.SubscribeTicker('PI_XBTUSD');
  // WebSocket: Subscribe to private account updates
  oFutures.SubscribeOpenPositions;
  oFutures.SubscribeAccountBalanceAndMargins;
end;

注意事項とベストプラクティス

スポットと先物の API キー

Kraken はスポット取引と先物取引に別々の API キーを使用します。Kraken の設定ページから各プラットフォーム専用のキーを生成してください。同じキーを両方のコンポーネントで再利用しないでください。

プライベートチャンネル用 WebSocket トークン

スポット取引所のプライベート WebSocket サブスクリプションには GetWebSocketsToken REST メソッドで取得した一時トークンが必要です。API 認証情報が設定されているとコンポーネントが自動的に処理しますが、トークンには有効期限があり必要に応じて更新されることに注意してください。

レート制限

Kraken は REST・WebSocket API の両方にレート制限を設けています。REST エンドポイントはカウンターベースのシステムを使用し、各呼び出しでカウンターが増加し時間とともに減少します。制限を超えると一時的なロックアウトが発生します。REST エンドポイントのポーリングではなく、リアルタイムデータには WebSocket サブスクリプションを使用してください。

資産ペアの命名規則

注：Kraken は REST と WebSocket API で異なる命名規則を使用します。REST エンドポイントは通常 XBTUSD のような連結名を使用し、WebSocket チャンネルはスラッシュ区切りの XBT/USD 形式を使用します。コンポーネントはこの違いを処理しますが、レスポンスを処理する際に念頭に置いてください。GetAssetPairs を使用してすべての利用可能なペアの正確な名前を確認できます。