概要 OHLCVローソク足時間枠オプションヒストリカルクエリ集計間隔クジラの動きの履歴資金調達率履歴バックテストデータ使用例ベストプラクティス

APIドキュメント

時系列データとヒストリカル分析クエリ

バックテスト、リサーチ、ヒストリカル分析のための包括的な時系列データにアクセス。OHLCVローソク足、ヒストリカル資金調達率、クジラの動きのタイムライン、複数の時間枠にわたる集計市場スナップショットをクエリできます。

公開日: 2026年3月21日 • 読了時間15分 • リサーチ

ヒストリカルデータ概要

Smart Money APIは24ヶ月分のヒストリカルデータを提供し、包括的なリサーチ、バックテスト、時間ベースの分析を可能にします。すべてのヒストリカルデータは正規化、重複排除され、複数の集計レベルで利用可能です。

利用可能なヒストリカルデータ:

OHLCVローソク足 — 全取引ペアの始値、高値、安値、終値、出来高
クジラの動き — 日次・時間単位のヒストリカルな蓄積/分配
資金調達率 — 全パーペチュアルペアのヒストリカル資金調達率スナップショット
オープンインタレスト — 全取引所・全時間枠のヒストリカルOIデータ
清算 — ヒストリカルな清算カスケードと圧力ポイント

データ保持期間: 全ティックデータは90日間保持。時間単位/日次集計データは24ヶ月間保持。生アーカイブはダウンロード可能。

OHLCVローソク足データ

テクニカル分析とチャート作成のための始値-高値-安値-終値-出来高データ。1分足から1ヶ月足まで、全暗号通貨ペアで利用可能。

OHLCVデータ構造

OHLCVローソク足
{
 "timestamp": 1709980800000,
 "symbol": "BTCUSDT",
 "timeframe": "1h",
 "open": 71250.50,
 "high": 72500.00,
 "low": 71000.25,
 "close": 72250.75,
 "volume_base": 1234.5,
 "volume_quote": 89234500,
 "trades": 45678
}

OHLCVデータのクエリ

ヒストリカルOHLCVクエリ
// 過去30日間の1時間足を取得
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

30秒でAPIキーを取得

構築準備はOK？無料APIキー（1日100回、カード不要）を取得し、ライブのクジラ動向、資金調達、オンチェーンデータの取得を開始しましょう。

APIキーを取得 →

利用可能な時間枠

時間枠オプション

時間枠	期間	使用例	最大ルックバック
1m	1分	高頻度取引、スキャルピング	30日
5m	5分	イントラデイ取引、スイングトレード	90日
15m	15分	デイトレード、シグナル検出	180日
1h	1時間	中期トレード、分析	365日
4h	4時間	スイングトレード、トレンド分析	24ヶ月
1d	1日	長期ポジション、リサーチ	24ヶ月
1w	1週間	マクロ分析、複数年のトレンド	24ヶ月
1M	1ヶ月	戦略的ポジション	24ヶ月

時間枠の組み合わせ

複数の時間枠を同時にクエリ:

マルチ時間枠クエリ
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// 各時間枠の最新ローソク足を返す

ヒストリカルクエリパターン

時間ベースクエリ

時間範囲クエリ
// 特定の時間範囲をクエリ
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// または相対ルックバックを使用
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

大規模データセットのページネーション

ページネーションパターン
// 最初のページ: 1000本のローソク足
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// カーソルを使用した次のページ
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

集計間隔

固定時間集計

固定間隔（毎時、毎日、毎週）でデータを集計:

固定集計
// 1ヶ月間の日次スナップショット
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

カスタム集計

カスタム時間枠で集計:

カスタムウィンドウ
// 1分足を15分足に集計
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

クジラの動きの履歴

クジラの履歴追跡

クジラ履歴
// クジラの蓄積パターンの履歴
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// 価格レベル周辺の履歴的な動き
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

クジラデータ構造

クジラデータポイント
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

ファンディングレート履歴

ファンディングレートスナップショットの履歴

ファンディングレート履歴
// 時間ごとのファンディングレートスナップショットを取得
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// 取引所間の履歴レートを比較
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

ファンディングレート統計

集計されたファンディングレート統計をクエリ:

統計クエリ
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// レスポンスに含まれるもの:
// - 年間平均ファンディングレート
// - 分布（標準偏差）
// - 履歴的な極値
// - パーセンタイルランク

バックテストデータアクセス

バックテストクエリ形式

Backtrader、VectorBT、カスタムエンジンなどのバックテストフレームワーク向けに最適化:

バックテストデータ
// 1年間のバックテスト用に全データを取得
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT&
  timeframe=1h&
  start=2024-01-01&
  end=2025-01-01&
  fields=ohlcv,funding_rate,oi,whale_flow

エクスポート形式

オフライン分析用に履歴データをダウンロード:

CSV — スプレッドシート用の標準的なカラム形式
JSON — すべてのメタデータを含む構造化形式
Parquet — データサイエンス用の圧縮カラム形式
HDF5 — 時系列最適化形式

エクスポートクエリ
// CSVとしてエクスポート
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

実践的な例

例1: 2024年ブルマーケットの調査

ブルマーケット分析
// クジラの動きと価格アクションを相関させる
GET /v1/historical/correlated-data?
  asset=BTC&
  start_time=2024-01-01&
  end_time=2024-12-31&
  include=ohlcv,whale_accumulation,funding_rates&
  interval=1d

例2: 資金調達レート戦略のバックテスト

戦略バックテスト
// 資金調達レート平均回帰戦略のデータを取得
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT,BNBUSDT&
  timeframe=4h&
  start=2023-01-01&
  end=2025-01-01&
  exchange=binance&
  fields=funding_rate,open_interest,liquidations

ヒストリカルデータのベストプラクティス

1. 適切な時間枠を選択

分析に必要な最小の時間枠を使用。1分足データは1時間足データより高価です。

2. 時間範囲を指定

常にstart_time/end_timeまたはlookbackパラメータを使用。終了時未指定のクエリは非効率です。

3. ヒストリカルクエリをキャッシュ

ヒストリカルデータは不変。積極的にキャッシュ（月次データは30日TTL）。

4. 大規模結果にはページネーションを利用

1年分の1分足データ=525,600本。大規模データセットにはページネーションとストリーミングを。

5. データ完全性を検証

分析使用前にレスポンスメタデータでギャップや欠損取引所を確認。

研究用ヒストリカルデータアクセス

24ヶ月分のOHLCV、クジラの動き、資金調達レートデータ。バックテスト、研究、戦略開発に最適。

プランを確認

無料枠: 30日分。Pro: 24ヶ月分。Enterprise: 完全アーカイブアクセス。