Binance で過去のローソク足データを表示する方法

Binance Webインターフェイス経由でローソク足データにアクセスする

1. Binance のスポット取引ページに移動し、BTC/USDT などの特定の取引ペアを選択します。

2. グラフ領域を見つけて、時間間隔のドロップダウンをクリックします。オプションには、1 分、5 分、15 分、1 時間、4 時間、1 日、1 週間、および 1 分が含まれます。

3. チャート キャンバスを右クリックしてコンテキスト メニューを開き、[データのエクスポート] を選択して、始値、高値、安値、終値、出来高、およびタイムスタンプのフィールドを含む CSV ファイルをダウンロードします。

4. 水平方向にドラッグするか、チャート ウィジェットの下部にあるズーム スライダーを使用して、表示されるチャートの範囲を調整します。

5. ローソク足の上にカーソルを置くと、ツールチップに正確な OHLCV 値と UTC タイムスタンプが表示されます。

Binance REST API を介した履歴データの取得

1. 必須パラメータ: シンボル (例: ETHUSDT)、間隔 (例: 1h)、およびオプションの startTime/endTime (ミリ秒単位) を使用して、 https://api.binance.com/api/v3/klinesへの GET リクエストを作成します。

2. 応答は、12 要素の配列の配列を返します。各サブ配列は、始値、始値、高値、安値、終値、出来高、終値時間、気配資産量、取引数、テイカーの買い基準ボリューム、テイカー買いの気配量、および無視フィールドをエンコードします。

3. バッチ サイズを制御するには、limit パラメータを使用します。最大許容値は 1000 です。ページネーションでは、startTime を最後の終了時刻に 1 ミリ秒を加えた値に調整する必要があります。

4. 処理速度制限: パブリック エンドポイントの場合、1 分あたり 1200 リクエスト。超過により、Retry-After ヘッダーを持つ HTTP 429 がトリガーされます。

5. /api/v3/timeから取得したサーバー時間に対してタイムスタンプを検証し、スキューによって引き起こされる取得間隔のギャップや重複を防ぎます。

AI エージェントに Binance 暗号通貨 MCP を使用する

1. Model Context Protocol サービスを Claude や Cursor などのエージェント フレームワークに統合して、ローソク足パターンに関する自然言語クエリを発行します。

2. 「2026 年 10 月 1 日から 10 月 10 日までの SOL/USDT の 4 時間のローソク足データを表示してください」などのプロンプトを送信すると、完全な kline 配列を含む構造化された JSON 応答を受け取ります。

3. 組み込みの時間ウィンドウ正規化を利用します。「過去 30 日間」を指定するクエリは自動的に解決され、UTC 午前 0 時に合わせて Unix エポック境界が修正されます。

4. ローソク足集計ロジックまたはタイムゾーン解釈の相違をデバッグするときに、生の API 結果に対して出力を相互検証します。

5. 応答内の「isFinal」ブール値フラグを解析して、最終的なローソク足と取引所側の調整がまだ残っている暫定的なローソク足を区別します。

データの整合性とタイムスタンプに関する考慮事項

1. すべてのローソク足のタイムスタンプは、終了時刻ではなく間隔の開始時刻を反映しているため、「2026-10-15」というラベルの付いた 1 日のローソク足は 00:00:00 UTC に始まり、23:59:59.999 UTC に終了します。

2. ローソク足の欠落は、流動性の低下によるものではなく、取引所のメンテナンス期間またはインフラストラクチャの障害時にのみ発生し、Binance サーバーによって補間されることはありません。

3. ボリューム値は基本資産ボリュームのみを表します。見積資産ボリュームは、必要に応じて終値乗算を使用して個別に導出する必要があります。

4. サーバー側のキャンドル生成では、取り込みタイムスタンプではなく、取引所が管理する注文照合タイムスタンプを使用し、すべてのデータ チャネルにわたる一貫性を確保します。

5. Binance は自動タイムゾーン変換を実行しないため、タイムゾーン対応クライアントは API リクエストを送信する前に現地時間入力を UTC に変換する必要があります。

よくある質問

Q: パブリック API を介して 1 年より古いローソク足データを取得できますか?はい。 /api/v3/klines エンドポイントは、各シンボルの上場日からの履歴データを提供します。 BTC/USDT は 2017 年 7 月以降のデータをサポートします。 PEPE/USDT のような新しいペアは発売日から始まります。

Q: エクスポートされた CSV ファイルに、特定の日付範囲で予想よりも少ない行が表示される場合があるのはなぜですか?これは、選択した時間間隔がそのペアの利用可能な取引履歴を超える場合に発生します。たとえば、10 日前に発売されたトークンに対して 1w のキャンドルをリクエストすると、1 行のみが生成されます。

Q: Binance は取引のキャンセルや修正後に過去のローソク足を調整しますか?いいえ、完成したキャンドルは、一度書き込まれた後は変更できません。 「暫定」とマークされたリアルタイムローソク足のみが最終決定前に変更される可能性があります。これらの変更は、更新された isFinal ステータスとともに後続の API 呼び出しに反映されます。

Q: 手作業で検査せずにローソクの連続性のギャップを検出する方法はありますか?連続する closeTime 値を比較します。次のローソク足の openTime が現在のローソク足の closeTime + インターバル期間を超える場合、ギャップが存在します。スクリプトを使用すると、大規模なバッチ全体でこの検証を自動化できます。