先物取引にコインベースAPIを使用する方法は？

APIを介してCoinbaseで先物を取引するには、「取引」権限を備えたキーを作成し、Advanced Trade APIを使用し、注文にレバレッジとマージンタイプを含めます。 （154文字）

2025/07/27 01:01

先物取引のコインベースAPIを理解する

Coinbase APIにより、開発者とトレーダーは、先物契約を含むCoinbaseの金融商品とプログラム的に相互作用することができます。スポット取引とは異なり、先物には、買い手または売り手が事前に決められた将来の日付と価格で資産を取引することを義務付ける契約が含まれます。 FuturesにAPIを使用するには、まず、CoinbaseがCoinbase Advanced Trade APIを介してこの機能を提供していることを理解する必要があります。取引を開始する前に、正しい権限、特に先物の「取引」範囲を備えたAPIキーを作成したことを確認してください。これがなければ、リクエストは403エラーを返します。

先物アクセスのためにAPIキーを設定します

開始するには、Coinbaseアカウントにログインして、 API設定セクションに移動します。 [新しいAPIキーの作成]をクリックし、「FutureBot」などの名前を割り当てます。許可パネルで、選択します。

• ビュー
• 貿易
• 移行
  セキュリティを追加するためにIPホワイトリストを有効にしてください。保存すると、CoinbaseはAPIキー、シークレット、およびパスフレーズを表示します。これらを安全に保存します - 公開リポジトリやクライアント側のコードではありません。 APIキーは、 CB-ACCESS-KEYヘッダー、 CB-ACCESS-PASSPHRASEのパスフレーズ、およびCB-ACCESS-TIMESTAMPで渡す必要があります。シークレットキーは、 HMAC SHA256を使用して各要求に署名するために使用されます。
  

  REST APIを介して先物注文を配置します

  
  先物注文を行うには、 https://api.coinbase.com/api/v3/brokerage/ordersに投稿リクエストを送信します。体には以下を含める必要があります。
• client_order_id ：生成する一意の識別子
• product_id ： BTC-USD-FUTUREのような形式
• side ： 'BUY'または'SELL'
• order_type ：価格制御に'LIMIT'を使用します
• price ：文字列形式、例： '50000.00'
• size ：文字列としての量、例えば、 '0.01'
• leverage ：1xから5xの間に文字列として設定します。たとえば、 '3'
• margin_type ：先物に対して'ISOLATED'いる必要があります
  ヘッダーには、認証トークンを含める必要があります。成功した場合、応答はorder_idを返します。リクエストが失敗した場合、 messageフィールドを検査します。たとえば、マージンが不十分な場合、 'Insufficient margin available'を返します。
  

  APIエンドポイントを使用したポジションとマージンの管理

  
  注文した後、エンドポイントを使用してポジションを監視してくださいGET https://api.coinbase.com/api/v3/brokerage/positions 。これは、以下を含むアクティブな先物のポジションを返します
• size ：現在の位置サイズ
• entry_price ：米ドルの平均エントリ
• unrealized_pnl ：浮動的な利益/損失
• liquidation_price ：位置が自動する価格
  オープンポジションでレバレッジを調整するには、 POST /api/v3/brokerage/positions/leverage使用します。体には以下を含める必要があります。
• product_id ：オープン位置と同じ
• leverage ：文字列としての新しいレバレッジ（例： '2' ）
  これは重要です。あなたのポジションが清算価格に近づくと、レバレッジを減らすと強制閉鎖を防ぐことができます。
  

  プログラムで先物注文のキャンセルとクロージング

  
  未使用注文をキャンセルするには、 /api/v3/brokerage/orders/{order_id}に削除リクエストを送信します。 {order_id}初期注文応答からIDに置き換えます。位置を閉じるために、反対側と一致するサイズの新しい注文を送信します。たとえば、0.01 BTCの長いポジションを保持している場合は、サイズのSELL注文size: '0.01'を配置します。 APIは、ワンクリック位置の閉鎖をサポートしません。これは、対立する注文を介して手動で行う必要があります。部分的な閉鎖や過剰販売を避けるために、閉じる前に位置のエンドポイントを介して位置サイズを常に確認してください。
  

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

  
  Coinbase APIはレート制限を強制します： APIキーごとに10秒あたりのリクエスト。これを超えると、429エラーが戻ります。コードに指数バックオフを実装します。各障害後に1秒、次に2、次に4などを待機します。一般的なエラーは次のとおりです。
• 400 Bad Request ：JSONフォーマットを確認します - 必要なすべてのフィールドは文字列です
• 401 Unauthorized ：タイムスタンプと署名生成を確認します
• 403 Forbidden ：APIキーには「トレード」範囲があることを確認します
• 422 Unprocessable Entity ：無効なProduct_idまたは1〜5xの範囲外でレバレッジ
  すべての応答をデバッグの問題に記録します。ライブトレーディングボットに統合する前に、ポストマンやカールなどのツールを使用してエンドポイントをテストします。
  

  よくある質問

  スポット取引と先物取引の両方に同じAPIキーを使用できますか？
  
  はい。ただし、キーに「ビュー」と「トレード」権限の両方が有効になっている場合のみ。先物固有のエンドポイントには、SpotのETH-USDとは異なる正しいProduct_ID形式（ ETH-USD-FUTUREなど）が必要です。

  私の先物のポジションが清算されるとどうなりますか？
  
  APIは、マーク価格が清算レベルに達したときに位置を自動的に閉じます。 Positions EndpointからAPI -Monitor liquidation_priceを介して通知を受け取り、外部からアラートを設定します。

  テストネットは先物API開発に利用できますか？
  
  いいえ、Coinbaseは先物のテストネットを提供していません。サンドボックスアカウントで少量の実際の資本を使用するか、展開する前に注文ロジックをローカルにシミュレートします。

  先物注文に必要なマージンを計算するにはどうすればよいですか？
  
  必要なマージン=（価格×サイズ） /レバレッジ。 3倍のレバレッジで50,000ドルの0.01 BTC注文の場合：（50000×0.01） / 3 = $ 166.67 。アカウントが少なくともこの金額を米ドルまたはstablecoinsで保持していることを確認してください。