Historical Cryptocurrency Light Chart加密货币历史快照
该接口返回多种加密货币的历史日线价格与成交量:回看价格演变、评估特定时段的市场活跃度,适合技术分析与回测,适用于数字资产全天候行情监控、跨周期动量回测与加密市场流动性分析。
https://quote-fmp.com/stable/historical-price-eod/light?symbol=BTCUSD数据更新周期
5-15 Minutes · 约 5~15 分钟更新
接口说明
- 日线价格:获取加密货币的历史日线(EOD)价格,分析长期市场趋势与规律,传入
symbol后可解析出price(最新价)、volume(成交量) 等字段,适合作为回测框架的基础数据层。 - 成交量数据:获取成交量数据,评估特定时段的市场活跃度,结合
price(最新价)与volume(成交量) 等明细维度,有助于对标的异动做归因拆解与交叉验证。 - 价格趋势分析:用这些数据回看加密货币价值的演变,辅助做出有依据的投资决策,在多因子回测管道里,常联合「加密货币全量历史」一起采集以丰富特征维度。
- 上下游关联接口:All Cryptocurrencies Quotes(加密货币批量报价) · 1-Minute Interval Cryptocurrency Data(加密货币1分钟分时) · Search Crypto News(加密货币新闻检索) · Forex Quote(外汇实时报价)
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | BTCUSD | 加密货币交易对代码(通常以 USD 计价),例如 BTCUSD(比特币兑美元)、ETHUSD(以太坊兑美元)、SOLUSD。 |
from | date | 可选 | 2026-01-27 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
to | date | 可选 | 2026-04-27 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
调用代码示例
Python 关键代码加密货币历史快照路径为 /stable/historical-price-eod/light(必填 symbol),响应 JSON 展开 price(最新价)、volume(成交量)、symbol(证券代码) 共 4 列。
resp = requests.get(
"https://quote-fmp.com/stable/historical-price-eod/light",
params={"symbol": "BTCUSD", "from": "2026-01-27", "to": "2026-04-27", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 price(最新价)
df["price"] = pd.to_numeric(df["price"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=BTCUSD 请求加密货币历史快照 | symbol=BTCUSD | 调用 /stable/historical-price-eod/light 拉取 BTCUSD 的加密货币历史快照,输出 price、volume、symbol 等 4 项标准化属性。 |
| 按 2024 年度窗口(from/to)切片拉取 BTCUSD 加密货币历史快照 | symbol=BTCUSD&from=2024-01-01&to=2024-12-31 | 限定 2024-01-01 至 2024-12-31 区间访问 /stable/historical-price-eod/light,获取 BTCUSD 该年度的 price、volume、symbol 序列。 |
| 切换主力品种 ETHUSD(以太坊)拉取加密货币历史快照 | symbol=ETHUSD | 改传 symbol=ETHUSD 访问 /stable/historical-price-eod/light,提取 以太坊 的 price、volume、symbol 做跨品种比对。 |
调用 /stable/historical-price-eod/light 拉取加密货币历史快照(必填 symbol)时,若条件未命中会返回 [];读取 price(64766.98828)与 volume 前须先判断 not df.empty。
/stable/historical-price-eod/light 的首条样本含 price=64766.98828;日常增量任务按 (symbol, date) 合并即可保持本地库与上游一致。
返回数据
4 个字段本接口示例响应共包含 4 个字段(数值型 2 个,文本/日期/布尔型 2 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "BTCUSD" | 证券代码 |
date | string | "2026-07-30" | 日期 |
price | number | 64766.98828 | 最新价 |
volume | number | 32030003200 | 成交量 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "BTCUSD",
"date": "2026-07-30",
"price": 64766.98828,
"volume": 32030003200
}
]常见问题解答(FAQ)
2 个问题加密货币历史快照(/stable/historical-price-eod/light)产出的 price 等字段,与 加密货币全量历史 的返回内容有何侧重?
加密货币历史快照(端点 /stable/historical-price-eod/light,必填 symbol)返回 price(最新价)及 volume(32030003200)共 4 列;若业务需要 Historical Cryptocurrency Full Chart(加密货币全量历史),可改调 /stable/historical-price-eod/full(必填 symbol)。
工程团队在封装 /stable/historical-price-eod/light(加密货币历史快照)客户端时,应采用怎样的拉取逻辑?
标准流程是用 from 与 to 按年度或季度分段请求 /stable/historical-price-eod/light;在拿到 加密货币历史快照 的 price 与 volume 后,及时释放内存中的原始文本流。
同模块相关接口对比
End Of Day本接口路径 /stable/historical-price-eod/light,必填参数 symbol。 同一模块「End Of Day」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 加密货币全量历史Historical Cryptocurrency Full Chart | /stable/historical-price-eod/full | 加密货币的日线级完整历史,开高低收(OHLC)、成交量、VWAP 等数据齐备 |