APIドキュメント丨公式API例丨非公式API例
リミットとは？
概要
リミットには3つのタイプがあり、いずれも随時変更される可能性があります：
- ハードリミット
- ML（機械学習）制限
- WAF（ウェブアプリケーション・ファイアウォール）リミット
ハードリミット：
- 毎分1,200リクエストのウェイト（必ずしも1,200リクエストと同じとは限らないことに注意してください）
- 10秒あたり50件の注文
- 24時間あたり16万件の注文
当社のハードリミットは、[/api/v3/exchangeInfo]エンドポイントに記載されています。
ML（機械学習）制限：
取引の様子は平均的なユーザーと比較して評価され、あまりにも逸脱した場合は、5分から3日の間、一定期間禁止されます。
取引上での乱用スコアがあるとします。以下の場合はスコアが上がります：
- オーダーブック上で「ワンアップ」または「フロントラン」を繰り返し最良のビッド/アスクを実行
- 取引を行うことなく注文のスパムやキャンセル何度も実行
- あなたの「コンバージョン率」は低いです。「コンバージョン率」とは、あなたの取引数を24時間以内の注文作成およびキャンセル数の合計で割った数値（注文数/（注文数＋キャンセル数））を指します。
- あなたの「ウェイト」が低い場合。「ウェイト」とは、あなたの総取引量を24時間以内の注文数およびキャンセル数の合計で割った数値（総取引量/（注文数＋キャンセル数））を指します。
- BNBをベース資産またはクォート資産とするペアで取引する場合、あなたの不正スコアは上昇
上記以外の具体的な情報は提供されません。理想的な取引パターンを実現するために試行錯誤したり、他のAPIユーザーと最適な動作について議論したりしてください。
WAF（ウェブアプリケーション・ファイアウォール）リミット
WAFルールの詳細は明らかにされていませんが、HTTP 403エラーが発生した場合はルール違反となります。大半の場合、5分以内の過度のリクエストが原因です。ただし、悪意があると見なされる可能性のリクエストを送信している場合は、より長い期間の禁止措置がとられる可能性があります。
制限を超えた場合、アカウント、APIキー、またはIPアドレスによって制限されますか？
ハードリミットについては、1分あたりの総リクエスト重量の制限（現在は1,200）を超えると、IPの使用が禁止されます。注文制限（現在は50回/10秒、160,000回/24時間）については、アカウントに依存します。注文制限を超えた場合、ユーザーはウェブサイト（または当社の他のアプリケーション）で新しい注文を作成することも制限されます。
機械学習の制限については、アカウントに制限が適用されます。機械学習による制限を受けたユーザーは、[/sapi/v1/account/status]エンドポイント（API Documentationに記載）を使用して、その理由と期間を確認することができます。
ウェブアプリケーションファイアウォールの制限は、IPごとにのみ適用されます。通常、WAFの禁止時間は5分となっています。ただし、サーバーがユーザーのリクエストを悪意あるものとして解釈した場合は、延長される可能性があります。
制限超過で規制されましたが、コードを修正しました。制限期間は早く解除されますか?
いいえ。禁止期間が終わるまで待つ必要があります。
API使用時にHTTP 403エラーが発生した理由とは?
WAF（ウェブアプリケーションファイアウォール ）のルールに違反しています。レート制限に違反しているか、悪意のあるリクエストを送信している可能性があります（このドキュメントの制限セクションでを参照しています）。通常、これらの禁止時間は5分となっています。
ウェブソケット接続がドロップ/切断されるのはなぜですか？
3分ごとに、アクティブなWebSocket接続は、Pingを受信します。正しくフレーム化されたPingで応答しない場合、接続が切断されます。
サードパーティのサービス/ラッパーを使用していますが、動作しません。ご協力いただけますか？
残念ながら、私たちはサードパーティのサービスやツールをサポートしていません。詳細については、サービスおよび開発者にお問い合わせしてください。
また、バイナンスAPIキーや秘密鍵をサードパーティのプラットフォームに入力することは、セキュリティ上のリスクとなります。これらのサービスは、お客様ご自身の判断でご利用ください。
なお、一般的なプログラミング支援も行わないことに注意してください。
何も変更を加えていないにもかかわらず、突然エラーが発生するようになりました。何が起こったのでしょうか？
残念ながら、お客様の個人的な実装に関する問題について、サポートを提供することができません。サードパーティのラッパー/ツールを使用している場合は、サポート/開発チームにお問い合わせください。
秘密鍵にアクセスする必要がありますが、「***」と表示されます。取得するにはどうすればいいのでしょうか？
セキュリティ上の理由から、設計上、秘密鍵は、APIキーが作成時のみ表示されます。それ以降は、いつでもマスクされます。秘密鍵を紛失した場合や記録していない場合は、新たにAPIキーを作成し、新たな秘密鍵で利用する必要があります。
制限または専用ストリーム/帯域幅を増加することはできますか？
残念ながら、現在は提供されていません。提供される制限の中で動作させることは可能なはずです。
私のAPIキーが紛失しました。助けてください！
APIキーが「消える」理由として考えられる可能性は2つです:
1. 最近アクティブになっておらず、2018年3月7日以前にAPIを使用していた場合は、アカウントのセキュリティを確保するためにAPIキーが削除された可能性があります。
2. お客様がアカウントの無効化を選択された場合、有効なAPIキーはすべて削除されます。
これで問題なく新しいAPIキーを作成できるはずです。
「Error -1021（メッセージ：このリクエストのタイムスタンプはrecvWindowの範囲外です）」と表示されました。これを解決するにはどうしたらいいでしょうか？
通常、このエラーは、サーバー時刻とシステム時刻の間に非同期がある場合にのみ発生します。システムクロックの同期が必要になる場合があります。ただし、このプロセスはオペレーティングシステムによって異なります。
Windowsの場合は、ご自身の判断で「Atomic Clock」などのツールをご利用ください。LinuxおよびMacユーザーの方は、コマンドラインから「ntpdate」で同期をお試し頂くことができます。
それでも問題が解決しない場合は、遅延 (ネットワーク問題) の可能性があり、recvWindowの調整が必要な場合があります。
新しいAPI機能をリクエストすることはできますか？
もし、あなたが要求している機能が当社のドキュメントに記載されていない場合、当社はその機能を提供していないと考えるべきです。機能提案をする場合は、サポートチケットを作成してください。
APIに問題があるのではないでしょうか。どのように報告すればよいのでしょうか？
お客様の実装ではなく、システムに問題があると思われる場合は、Telegram APIチャットにて当社にご連絡いただき、主張を裏付ける証拠をご提示いただければ、調査させていただきます。漠然としたメッセージは、正当な苦情として認められませんのでご了承ください。さらに、これは公式のプログラミングサポートのためのグループでは なく、Binance APIユーザーのためのコミュニティグループです。
最終更新日 2022年5月16日