Batch Forex Quotes外汇批量报价
该接口一次请求返回多个货币对的实时报价:价格、涨跌与成交量一并获取,可用于持续跟踪全球汇率与不同市场的价格波动。
https://quote-fmp.com/stable/batch-forex-quotes数据更新周期
Real-Time · 实时更新
接口说明
- 追踪全球汇率:获取全球范围大量货币对的实时价格,调用后可采集
price(最新价)、change(涨跌额)与volume(成交量) 等字段,契合自动化报表与看板的数据源要求。 - 批量数据获取:一次请求返回多个货币对的实时报价,包括价格、涨跌与成交量,配合
price(最新价)与change(涨跌额) 等返回项,能高效支撑同行业标的横向比对。 - 适合高频交易:对需要快速、高效监控大量货币对的交易员和分析师尤为实用,研究端可将本接口与「外汇实时报价」组合编排,覆盖从概览快照到历史序列的需求。
- 上下游关联接口:Forex Currency Pairs(外汇货币对清单) · Historical Forex Light Chart(外汇历史行情(轻量)) · Treasury Rates(美国国债收益率) · Economic Data Releases Calendar(经济数据日历)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
short | boolean | 可选 | true | 是否返回精简字段集:true 返回核心字段(适用于批量行情,减小响应体积),false 返回完整字段。 |
调用代码示例
Python 关键代码外汇批量报价路径为 /stable/batch-forex-quotes(可选 short),响应 JSON 展开 price(最新价)、change(涨跌额)、volume(成交量) 共 4 列。
resp = requests.get(
"https://quote-fmp.com/stable/batch-forex-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 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 拉取外汇批量报价完整字段模式(short=false) | short=false | 设 short=false 请求 /stable/batch-forex-quotes,返回包含 price、change、volume(price=0.38716)在内的全量字段。 |
| 拉取外汇批量报价轻量级快照模式(short=true) | short=true | 设 short=true 调用 /stable/batch-forex-quotes,仅保留核心价格与成交量以加速批量刷屏。 |
调用 /stable/batch-forex-quotes 拉取外汇批量报价(可选 short)时,若条件未命中会返回 [];读取 price(0.38716)前须先判断 not df.empty。
/stable/batch-forex-quotes 的首条样本含 price=0.38716;日常增量任务按 (symbol) 合并即可保持本地库与上游一致。
返回数据
4 个字段本接口示例响应共包含 4 个字段(数值型 3 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AEDAUD" | 证券代码 |
price | number | 0.38716 | 最新价 |
change | number | -0.00513532 | 涨跌额 |
volume | number | 0 | 成交量 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AEDAUD",
"price": 0.38716,
"change": -0.00513532,
"volume": 0
}
]常见问题解答(FAQ)
2 个问题外汇批量报价(/stable/batch-forex-quotes)产出的 price 等字段,与 外汇实时报价 的返回内容有何侧重?
外汇批量报价(端点 /stable/batch-forex-quotes,可选 short)返回 price(最新价)及 change(-0.00513532)共 4 列;若业务需要 Forex Quote(外汇实时报价),可改调 /stable/quote(必填 symbol)。
工程团队在封装 /stable/batch-forex-quotes(外汇批量报价)客户端时,应采用怎样的拉取逻辑?
标准流程是传入精确匹配的 short 参数调用 /stable/batch-forex-quotes;在拿到 外汇批量报价 的 price 与 change 后,及时释放内存中的原始文本流。
同模块相关接口对比
Quotes本接口路径 /stable/batch-forex-quotes,无必填参数。 同一模块「Quotes」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。