APIに関するよくある質問(FAQ)

Binance
2018-06-05 09:38

APIドキュメント作成非公式なAPIの例 

リミットとは?

概要
リミットには3つのタイプがあり、いずれも随時変更される可能性があります:
  1. ハードリミット
  2. ML(機械学習)リミット
  3. 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分毎に、アクティブなウェブソケット接続がpingを受信します。適切にフレーム化されたPongで応答しない場合、接続は終了します。
ユーザーデータストリームの場合、少なくとも60分に1回のキープアライブが受信されないと、リッスンキーは失効します。これについては、APIドキュメントでも詳しく説明されています

サードパーティのサービス/ラッパーを使用していますが、動作しません。ご協力いただけますか?

残念ながら、私たちはサードパーティのサービスやツールをサポートしていません。詳細については、サービスおよび開発者にお問い合わせしてください。
また、バイナンス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チャットにて当社にご連絡いただき、主張を裏付ける証拠をご提示いただければ、調査させていただきます。漠然としたメッセージは、正当な苦情として認められませんのでご了承ください。さらに、これは公式のプログラミングサポートのためのグループではなく、バイナンスAPIユーザーのためのコミュニティグループです。
関連記事