時間序列數據與歷史分析查詢

獲取全面的時間序列數據,用於回測、研究和歷史分析。查詢 OHLCV 蠟燭圖、歷史資金費率、鯨魚資金動向時間線以及跨多個時間框架的聚合市場快照。

發佈於 2026 年 3 月 21 日 15 分鐘閱讀 研究

歷史數據概述

Smart Money API 提供 24 個月的歷史數據,支持全面的研究、回測和基於時間的分析。所有歷史數據均經過標準化、去重複處理,並提供多種聚合級別。

可用的歷史數據包括:

  • OHLCV 蠟燭圖 — 所有交易對的開盤價、最高價、最低價、收盤價和成交量
  • 鯨魚資金動向 — 每日和每小時解析度的歷史累積/分佈
  • 資金費率 — 所有永續合約對的歷史資金費率快照
  • 未平倉合約 — 所有交易所和時間框架的歷史 OI 數據
  • 清算數據 — 歷史清算連鎖反應和壓力點

數據保留: 完整 tick 數據保留 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 密鑰

準備開始構建?立即獲取免費 API 密鑰(每天 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根K線
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分鐘K線聚合為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分鐘數據比小時數據成本更高。

2. 指定時間範圍

始終使用start_time/end_time或lookback參數。開放式查詢效率低下。

3. 緩存歷史查詢

歷史數據不可變。積極緩存(月度數據設置30天TTL)。

4. 對大型結果使用分頁

1年內的1分鐘數據=525,600根K線。對大型數據集使用分頁和流式傳輸。

5. 驗證數據完整性

在分析中使用數據前,檢查響應元數據中的缺口或缺失交易所。

獲取研究用歷史數據

24個月的OHLCV、巨鯨動向和資金費率數據。完美適用於回測、研究和策略開發。

查看方案
免費層級:30天歷史數據。專業版:24個月。企業版:完整檔案訪問權限。

相關資源

免費開始 — 每天100次調用,無需綁卡

從單一API獲取3家交易所的實時巨鯨資金流、資金費率、持倉量和鏈上數據。免費層級無需信用卡,隨時升級。

免費開始 →
試用實時API控制台 → (無需帳戶)