ETF Price QuotesETF实时报价
该接口返回各 ETF 的实时价格与表现数据,包括最新价格、涨跌幅等关键行情信息,便于监控与比较多个 ETF。
https://quote-fmp.com/stable/batch-etf-quotes数据更新周期
N/A · 不适用固定周期
接口说明
- 监控 ETF 表现:及时掌握各 ETF 的最新价格和表现指标,调用后可输出
price(最新价)、change(涨跌额)与volume(成交量) 等结构化字段,省去繁琐的网页抓取与文本清洗。 - 评估投资机会:用实时价格数据评估 ETF 的价值,做出有据的投资决策,依据
price(最新价)与change(涨跌额) 等字段的变化斜率,可及时捕捉基本面或交易面边际变化。 - 跨 ETF 表现横向对比:轻松跟踪和比较多个 ETF 的表现,优化投资组合策略,日常复盘时可联动同模块的「外汇批量报价」,互相印证关键数据的边际变化。
- 关联数据线接口:Stock Quote(股票报价) · Stock Quote Short(精简报价) · Global Exchange Market Hours(全球交易所交易时段) · Company Profile Data(公司概况)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
short | boolean | 可选 | true | 是否返回精简字段集:true 返回核心字段(适用于批量行情,减小响应体积),false 返回完整字段。 |
调用代码示例
Python 关键代码拉取 ETF实时报价 只需访问 /stable/batch-etf-quotes(可选 short),结果涵盖 price(最新价)、change(涨跌额)、volume(成交量)(price=6.33)。
resp = requests.get(
"https://quote-fmp.com/stable/batch-etf-quotes",
params={"short": "true", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price(最新价)
df["price"] = pd.to_numeric(df["price"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取ETF实时报价完整字段模式(short=false) | short=false | 设 short=false 请求 /stable/batch-etf-quotes,返回包含 price、change、volume(price=6.33)在内的全量字段。 |
| 拉取ETF实时报价轻量级快照模式(short=true) | short=true | 设 short=true 调用 /stable/batch-etf-quotes,仅保留核心价格与成交量以加速批量刷屏。 |
在ETF实时报价(/stable/batch-etf-quotes)中,首条样本的 price 为 6.33;批量采集时请按可选 short校验传参格式。
存储ETF实时报价(/stable/batch-etf-quotes)数据时,主键 (symbol) 能唯一标识每条截面;注意 price(最新价,样本 6.33)采用原始计价单位。
返回数据
4 个字段本接口示例响应共包含 4 个字段(数值型 3 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "P60.SI" | 证券代码 |
price | number | 6.33 | 最新价 |
change | number | 0 | 涨跌额 |
volume | number | 1 | 成交量 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "P60.SI",
"price": 6.33,
"change": 0,
"volume": 1
}
]常见问题解答(FAQ)
2 个问题使用「Batch List」接口族时,ETF实时报价(可选 short)与 交易所全量报价(必填 exchange)怎么选?
按输入参数看,/stable/batch-etf-quotes(ETF实时报价)为可选 short,产出 price(6.33)等 4 列;/stable/batch-exchange-quote(Exchange Stock Quotes(交易所全量报价))为必填 exchange,产出 4 列。
在自动化流水线中对接ETF实时报价(/stable/batch-etf-quotes),怎样平衡拉取深度与请求效率?
最佳实践是按 short 过滤条件请求 /stable/batch-etf-quotes 并做非空校验;解析响应中的 price(如 6.33)前,请确保对异常空值和网络超时设置退避重试。
同模块相关接口对比
Batch List本接口路径 /stable/batch-etf-quotes,无必填参数。 同一模块「Batch List」下共 7 个接口,下表列出其余 6 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 交易所全量报价Exchange Stock Quotes | /stable/batch-exchange-quote | 一次返回指定交易所所有上市股票的实时报价,包括价格、成交量与涨跌信息 |
| 公募基金报价Mutual Fund Price Quotes | /stable/batch-mutualfund-quotes | 各类公募基金的实时价格与表现数据,包括最新价格、涨跌变化等关键信息,便于监控基金行情 |
| 大宗商品批量报价Full Commodities Quotes | /stable/batch-commodity-quotes | 一次请求即可返回多种大宗商品的实时行情,最新价格、涨跌变化、成交量等关键指标 |
| 加密货币批量报价Full Cryptocurrency Quotes | /stable/batch-crypto-quotes | 一次请求返回多种加密货币的实时行情,最新价格、涨跌变化与成交量 |
| 外汇批量报价Full Forex Quote | /stable/batch-forex-quotes | 一次请求返回多个货币对的实时报价,价格、涨跌与成交量一并获取 |
| 全指数报价Full Index Quotes | /stable/batch-index-quotes | 一次请求返回全部可用股指的实时报价 |