Coinbase Advanced Trade API の使用方法? (ボット開発)

認証とAPIキーの設定

1. Coinbase Advanced Trade ダッシュボードに移動し、ユーザー メニューから[API 設定]を選択します。

2. [Create API Key]をクリックし、権限を慎重に選択します。 trade 、 view 、およびtransferスコープはボットの機能に不可欠です。

3. わかりやすい名前を割り当て、固定サーバーから実行している場合は IP アドレスを制限し、作成を確認します。

4. API キー、シークレット、パスフレーズを暗号化された環境変数システムに保存します。ソース ファイルにハードコードしないでください。

5. HTTP メソッド、リクエスト パス、および本文を使用してタイムスタンプ付きメッセージを作成し、シークレットを使用して HMAC-SHA256 で署名することにより、署名の生成を検証します。

注文ライフサイクル管理

1. POST /api/v3/brokerage/orders経由で、product_id (例: BTC-USD)、side (買い/売り)、client_order_id、サイズを指定して指値注文を送信します。

2. GTC や GTT などのtime_in_force値を使用して注文期間を制御します。ボットは多くの場合、古い配置を避けるために 60 秒の有効期限を持つ GTT に依存します。

3. DELETE /api/v3/brokerage/orders/{order_id}を使用して保留中の注文をキャンセルするか、フィルタを使用してDELETE /api/v3/brokerage/orders を使用してバッチキャンセルします。

4. ページネーションを使用してGET /api/v3/brokerage/orders/historyalをポーリングし、実行された約定をローカル状態と照合します。

5.ステータスフィールドを厳密に解析します。open 、 done 、 rejected 、およびpending には、実行ロジックで個別の処理パスが必要です。

リアルタイムの市場データの統合

1. wss://ws-feed.exchange.coinbase.comで WebSocket フィードに接続し、レベル 2またはティッカーチャネルに登録して、リアルタイムの買値/売値更新を行います。

2. REST 呼び出しに使用されるのと同じ資格情報から派生したproduct_ids 、 Channels 、および署名を含む JSON サブスクリプション メッセージを送信します。

3. チャネルごとのシーケンス番号を維持して、欠落したメッセージを検出します。ギャップが許容しきい値を超えた場合は、ドロップして再サブスクライブします。

4. スプレッド、デプス、またはボラティリティのメトリクスを計算する前に、受信した価格およびサイズのフィールドを 10 進数タイプに正規化します。

5.ハートビートメッセージを使用して接続の活性度を検証し、間隔が 30 秒を超えた場合に再接続ロジックをトリガーします。

エラー処理とレート制限

1. HTTP ステータス コードを検査します。429はレート制限の枯渇を示します。Retry -Afterヘッダーを尊重し、指数バックオフを実装します。

2. 401 を資格情報の無効化として扱います。ローカルな変更を行わずに繰り返された場合、キーをローテーションします。

3. 400 の応答を特定の検証エラー (フィールドの欠落、無効な product_id、または不正なタイムスタンプ) にマッピングし、 valid_client_order_idなどの正確なエラー コードをログに記録します。

4. 500 シリーズのエラーを一時的なインフラストラクチャの問題として捉えます。冪等性キーを使用して後で再実行できるように、失敗したリクエストをキューに入れます。

5. X-Request-IDヘッダーで返されたすべてのリクエスト ID を記録し、インシデント解決中にログを Coinbase サポート チケットと関連付けます。

よくある質問

Q: サンドボックス環境と本番環境の両方で同じ API キーを使用できますか?いいえ。サンドボックスと運用環境では、それぞれ独自のベース URL、認証情報、権限スコープを持つ個別の API キーを作成する必要があります。

Q: Coinbase Advanced Trade は API 経由のストップリミット注文をサポートしていますか?はい。注文ペイロードでstopおよびstop_priceパラメータを、 stop_limitに設定されたorder_typeとともに使用します。

Q: ボットの署名が Coinbase の期待と一致していることを確認するにはどうすればよいですか?署名を段階的に再現します。タイムスタンプ + メソッド + request_path + body を連結し、base64 でデコードされたシークレットを使用して HMAC-SHA256 を計算します。出力をCB-ACCESS-SIGNヘッダー値と比較します。

Q: 過去の注文エンドポイントをポーリングできる頻度に制限はありますか?はい。 /historyalエンドポイントは、標準の注文エンドポイントよりも厳しいレート制限を適用します (通常、API キーごとに 1 分あたり 30 リクエスト)。