Coinbase APIを使用して契約を取引するにはどうすればよいですか？

Coinbase Advanced Trade APIは、先物や永続的な契約ではなく、実際の暗号を増やして販売するスポット取引のみをサポートしています。

2025/08/12 17:14

Coinbase APIとその機能を理解します

Coinbase APIは、開発者とトレーダーがCoinbaseの金融サービスとプログラム的にやり取りできるようにする強力なツールです。 Coinbaseは、スポット取引、ウォレット管理、価格データの検索など、幅広い機能を提供していますが、Coinbaseは現在、標準APIを通じて取引先物や永続的な契約をサポートしていないことを明確にすることが重要です。 Coinbase Advanced Trade APIの主な焦点は、現在の市場価格で実際の暗号通貨を売買することを意味するスポット取引にあります。

それにもかかわらず、多くのユーザーは、コインベースとコインベース誘導体またはコインベースの国際交換を混同します。これは、先物取引を提供する別個のエンティティです。これらのプラットフォームは、さまざまな規制フレームワークとAPIで動作します。あなたの目標が先物やオプションなどの契約を取引することである場合、正しいコインベース関連サービスを使用しているかどうかを確認する必要があります。現在、 Coinbase Advanced Trade APIは、制限注文、市場注文、暗号通貨ペアの停止注文など、スポット市場運用のみをサポートしています。

APIの使用を開始するには、まずCoinbase Advanced Tradeでアカウントを作成し、APIキーを生成する必要があります。これらのキーは、アプリケーションが取引口座へのアクセスを許可するため、アクセス許可を慎重に管理することが不可欠です。キーを生成するとき、「ビュー」、「トレード」、「転送」などの特定の役割を割り当てることができます。取引のために、「取引」の許可が有効になっていることを確認してください。

Coinbase APIキーをセットアップします

取引を行う前に、API資格情報を使用してリクエストを認証する必要があります。キーを生成して構成する方法は次のとおりです。

• Coinbase Advanced Tradeアカウントにログインします
• 設定> APIに移動します
• [ +新しいAPIキー]をクリックします
• 適切な権限を選択します： 「表示」と「取引」
• キーの名前を入力します（たとえば、「トレーディングボット」）
• 完全な2要素認証（2FA）
• 生成されたAPIキー、シークレット、およびパスフレーズをコピーします

これらの資格情報を安全に保存します。秘密とパスフレーズは一度だけ表示され、失われた場合は取得できません。クライアント側のコードまたはパブリックリポジトリでそれらを公開しないでください。

キーができたら、それらをアプリケーションに統合し始めることができます。 APIはHMAC-SHA256認証を使用します。各リクエストには、次のヘッダーを含める必要があります。

• CB-ACCESS-KEY ：APIキー
• CB-ACCESS-SIGN ：メッセージのHMAC署名
• CB-ACCESS-TIMESTAMP ：リクエストのUNIXタイムスタンプ
• CB-ACCESS-PASSPHRASE ：設定したパスフレーズ

署名は、秘密を使用してタイムスタンプ、HTTPメソッド、リクエストパス、およびボディ（もしあれば）の連結をハッシュすることによって生成されます。

Coinbase APIを介してスポット取引を作成します

契約取引はサポートされていませんが、Advanced Trade APIを使用してスポット取引を実行できます。これらの取引には、現在の市場価格での暗号通貨の即時交換が含まれます。注文するには、 「順序の作成」エンドポイントを使用します。

BTC-USDの制限購入注文を配置する例は次のとおりです。

• HTTPメソッド： POST
• エンドポイント： https://api.coinbase.com/api/v3/brokerage/orders
• リクエストボディ：

   {
   'client_order_id': 'unique-id-123',
   'product_id': 'BTC-USD',
   'side': 'BUY',
   'order_configuration': {
   'limit_limit_gtc': { 'base_size': '0.001', 'limit_price': '30000.00'

  }
  }
  }

重要なパラメーターは次のとおりです。

• client_order_id ：ご注文の一意の識別子
• product_id ：トレーディングペア（例：BTC-USD）
• side ： 「購入」または「販売」
• base_size ：取引する暗号通貨の量
• limit_price ：あなたが支払う意思がある最大価格

アカウントが購入に十分なUSD残高または販売用のBTC残高を確保してください。注文は市場の可用性に基づいて実行され、部分的に満たされる場合があります。

Orderステータスを確認するには、 order_id応答で返されたときに「Order Get Order」エンドポイントを使用します。また、ステータス用のフィルターを使用して「リスト注文」エンドポイントを使用してすべての注文をリストすることもできます（オープン、フィル、キャンセル）。

市場データの取得と監視価格

取引の成功には、最新の市場情報が必要です。 Coinbase APIは、リアルタイムおよび履歴データを取得するためのいくつかのエンドポイントを提供します。

最新のベスト入札を取得し、製品の価格を尋ねるには：

• endpoint： GET /api/v3/brokerage/product/book?product_id=BTC-USD&limit=1
• 応答は次のとおりです。
  • トップ入札のpriceとsize
  • 一番上の質問のpriceとsize

ろうそく足データ（テクニカル分析で使用）については、以下を使用してください。

• エンドポイント： GET /api/v3/brokerage/market/products/BTC-USD/candles
• クエリパラメーター： type=1_MINUTE 、 start=1700000000 、 end=1700003600

これにより、指定された時間範囲と間隔に対してOHLC（オープン、ハイ、ロー、クローズ）値が返されます。

また、複数のレベルで注文書を取得することもできます。

• limit=50上位50の入札を与え、尋ねます
• このデータを使用して市場の深さを分析し、価格の動きを予測します

これらのエンドポイントを定期的にポーリングすると、ライブトレーディングダッシュボードを構築したり、意思決定ロジックを自動化したりすることができます。

取り扱いエラーとレート制限

コインベースAPIは、虐待を防ぐためにレート制限を強制します。エンドポイントを取引する場合、制限は通常、APIキーごとに10秒あたり10リクエストです。これを超えると、 429 Too Many Requests 。これを避けるために：

• 再試行ロジックに指数バックオフを実装します
• 可能であれば、応答をキャッシュします
• 頻繁に投票する代わりに、リアルタイムデータにWebSocketsを使用します

一般的なエラーコードは次のとおりです。

• 401 Unauthorized ：無効または欠落API資格情報
• 403 Forbidden ：不十分な権限
• 404 Not Found ：無効な製品IDまたは注文ID
• 400 Bad Request ：不正なJSONまたは無効なパラメーター

常に入力を検証し、エラーを優雅に処理します。たとえば、注文する前にETH-USDのような製品IDがサポートされているかどうかを確認してください。

よくある質問

APIを使用してコインベースで先物を交換できますか？

いいえ、 Coinbase Advanced Trade APIは、先物または永続的な契約をサポートしていません。スポット取引のみに限定されます。 Futures Tradingは、 Coinbase Derivativesで利用できます。これには、APIインターフェイスが別々の場合があります。

CoinbaseとCoinbase Advanced Trade APIの違いは何ですか？
Coinbase.comは、CryptoをFiatで購入するための消費者向けのプラットフォームです。 Advanced Trade APIは、自動化された取引のためのプロのグレードのインターフェイスであり、スポット市場、注文書、価格データへのプログラムアクセスを提供します。

APIを介してオープンオーダーをキャンセルするにはどうすればよいですか？

DELETE /api/v3/brokerage/orders/{order_id}エンドポイントを使用します。 {order_id}実際の順序識別子に置き換えます。応答は、注文が既に入力または無効である場合、キャンセルを確認するか、エラーを返します。

自動取引にAPIキーを使用しても安全ですか？

はい、ベストプラクティスが守られている場合。強力でユニークなパスフレーズを使用し、必要なもののみに許可を制限し、暗号化された環境にキーを保存し、スクリプトでハードコードを避けます。利用可能な場合は、 IPホワイトリストの使用を検討してください。