时间序列数据与历史分析查询

获取全面的时间序列数据用于回测、研究和历史分析。查询OHLCV K线、历史资金费率、巨鲸资金动向时间线以及跨多时间周期的聚合市场快照。

发布于2026年3月21日 15分钟阅读 研究

历史数据概览

Smart Money API提供24个月的历史数据,支持全面研究、回测和基于时间的分析。所有历史数据均经过标准化处理、去重,并提供多级聚合。

可用的历史数据包括:

  • OHLCV K线 — 所有交易对的开盘价、最高价、最低价、收盘价及成交量
  • 巨鲸动向 — 按日/小时粒度记录的累积/分布历史
  • 资金费率 — 所有永续合约对的历史资金费率快照
  • 未平仓合约 — 全交易所及全时间周期的历史OI数据
  • 强平数据 — 历史强平瀑布链与压力点

数据保留政策: 全量tick数据保留90天。聚合小时/日级数据保留24个月。支持原始数据归档下载。

OHLCV K线数据

开盘-最高-最低-收盘-成交量数据,用于技术分析与图表绘制。支持1分钟至1月周期所有加密货币交易对。

OHLCV数据结构

OHLCV K线
{
"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小时K线
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
// 返回各周期最新K线

历史查询模式

时间范围查询

指定时间范围查询
// 查询特定时间范围
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控制台 → (无需注册账号)