Batch Forex Quotes外汇批量报价

该接口一次请求返回多个货币对的实时报价:价格、涨跌与成交量一并获取,可用于持续跟踪全球汇率与不同市场的价格波动。

GEThttps://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 个参数
参数类型要求示例说明
shortboolean可选true是否返回精简字段集:true 返回核心字段(适用于批量行情,减小响应体积),false 返回完整字段。

调用代码示例

Python 关键代码

外汇批量报价路径为 /stable/batch-forex-quotes(可选 short),响应 JSON 展开 price(最新价)、change(涨跌额)、volume(成交量) 共 4 列。

Python(核心参数与字段清洗逻辑)
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:判空容错与 price(最新价)读取

调用 /stable/batch-forex-quotes 拉取外汇批量报价(可选 short)时,若条件未命中会返回 [];读取 price(0.38716)前须先判断 not df.empty。

落库主键与口径对接 /stable/batch-forex-quotes:以 (symbol) 防重并提取 price(最新价)

/stable/batch-forex-quotes 的首条样本含 price=0.38716;日常增量任务按 (symbol) 合并即可保持本地库与上游一致。

返回数据

4 个字段

本接口示例响应共包含 4 个字段(数值型 3 个,文本/日期/布尔型 1 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。

字段类型示例值说明
symbolstring"AEDAUD"证券代码
pricenumber0.38716最新价
changenumber-0.00513532涨跌额
volumenumber0成交量
查看响应数据示例(原始 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 个, 按粒度与查询维度对比,避免选错接口。

接口路径核心差异与适用场景
外汇实时报价Forex Quote/stable/quote货币对的实时汇率报价,包括当前价格、日内与年度高低点、涨跌幅以及 50 日和 200 日均线等关键数据
外汇简要报价Forex Short Quote/stable/quote-short以精简格式返回货币对的实时汇率、最新涨跌幅和成交量,适合需要快速查看行情、做快速决策的场景

Forex(外汇数据)全部接口目录 →

需要稳定访问 外汇批量报价 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月