ボットを取引するために Binance API を使用するにはどうすればよいですか? (開発者ツール)

API認証情報のセットアップ

1. Binance アカウントにログインし、[セキュリティ] の [API 管理] セクションに移動します。

2. 「API の作成」をクリックし、取引範囲に応じて標準 API または統合取引 API を選択します。

3. わかりやすい名前を割り当て、セキュリティを強化するために IP ホワイトリストを有効にします。信頼されたサーバーのみがリクエストを開始できます。

4. 電子メールと 2FA で作成を確認し、API キーと秘密キーの両方を安全に保存します。これらはページを更新した後に再度取得することはできません。

5. 認証情報が漏洩した場合の危険を最小限に抑えるために、「出金」や「証拠金送金」などの未使用の権限を無効にします。

認証フローを理解する

1. すべてのプライベート エンドポイントでは、秘密キーと正規のリクエスト文字列を使用した HMAC-SHA256 署名の生成が必要です。

2. タイムスタンプ パラメーターは、Binance サーバー時間の 1000 ミリ秒以内に同期する必要があります。署名する前に、 /api/v3/timeエンドポイントを使用して正確なサーバー時間を取得します。

3. GET リクエストのクエリ文字列または POST リクエストのリクエスト本文に、X-MBX-APIKEY ヘッダーの API キーとともに署名を含めます。

4. ノンス値は、厳密に増加する整数またはミリ秒のタイムスタンプである必要があります。値を再利用またはスキップすると、拒否が引き起こされます。

5. IP および API キーごとにレート制限が適用されます。レート制限を超えると、Retry-After ヘッダー付きの HTTP 429 が返されます。ボットに指数バックオフ ロジックを実装します。

スポット注文操作の実行

1. POST /api/v3/orderを使用して、シンボル、サイド、タイプ、数量、価格などの正確なパラメーターを指定して、指値注文、成行注文、ストップロス注文、または利益確定注文を発注します。

2. test=trueを設定してテスト モードを有効にすると、実際の実行を行わずに注文構造を検証できます。これは統合テストに最適です。

3. clientOrderId または orderId を使用して、 GET /api/v3/orderを介してリアルタイムの注文ステータスを取得します。これにより、約定済みの数量、平均価格、および現在のステータスが返されます。

4. シンボルと orderId または origClientOrderId を指定してDELETE /api/v3/order を使用して保留中の注文をキャンセルします。

5. シンボルとオプションの制限を指定してGET /api/v3/myTradesを使用して、最近の取引履歴を取得します。取引は時系列の降順で返されます。

アカウントデータと残高の管理

1. GET /api/v3/accountを呼び出して、スポット ウォレット全体のフリー、ロック、および合計金額を含むすべての資産残高を取得します。

2. 売買ロジックを開始する前に残高配列をチェックし、空き> 0 を検証することにより、資産を動的にフィルターします。

3. クロスまたは分離マージン モードを利用する場合は、 GET /sapi/v1/margin/accountを使用してマージン レベルの変化を監視します。

4. updateTimeフィールドを解析して、古いバランス スナップショットを検出します。更新間隔は、ボットの意思決定の待ち時間と一致する必要があります。

5. myTradesのtradeIdを実行された注文 ID と関連付けることにより、注文約定に対する残高更新をクロスチェックします。

よくある質問

Q: 複数のボットで同じ API キーを使用できますか? A: はい、ただし、リスク面が増大します。1 つのボットが侵害されると、リンクされているすべての操作が危険にさらされます。最小限の権限を持つボットごとに専用のキーを使用することを推奨します。

Q: 署名されたリクエストが「無効な署名」を返すのはなぜですか? A: ほとんどの場合、署名生成中の誤った文字列連結、±1000 ミリ秒を超えるクロック スキュー、または送信前の署名自体の誤った URL エンコードが原因です。

Q: WebSocket ストリーミングはリアルタイムの注文帳更新でサポートされていますか? A: はい - wss://stream.binance.com:9443/ws/{symbol}@ Depthに接続して生の L2 オーダーブック データを取得するか、1 つの接続で複数のシンボルの結合ストリームを使用します。

Q: API のダウンタイムや 503 応答はどのように処理すればよいですか? A: サーキット ブレーカー パターンを実装します。連続した障害を追跡し、設定可能な期間リクエストを一時停止し、 GET /api/v3/pingによるヘルス チェックが成功した場合にのみ再開します。