Forex（外汇数据）

此类接口提供外汇行情信息，包括货币对清单、实时汇率、多币种批量报价，以及日线和 1 分钟到 1 小时的历史行情。货币对使用 EURUSD 这类无分隔符写法，接入前建议先调一次货币对目录确认代码；返回的是参考汇率，与银行实际成交价之间存在点差。

典型使用场景

4 个场景

汇率换算

为跨境电商、财务报表和资产估值提供统一汇率。

外汇回测

下载日线或分钟序列研究趋势和波动。

多币种组合

将不同币种资产统一换算到基准货币。

跨国财报币种折算

结合非美上市公司的 reportedCurrency 与历史日线汇率统一折算美元口径财报。

接口怎么选？

5 项选型对照

外汇类别按“货币对发现、当前汇率、历史序列”三步组织接口：先通过 Forex Currency Pairs（外汇货币对清单）确认合法的无分隔符代码（如 EURUSD、USDJPY），再按需选择实时快照或历史 K 线。

单货币对监控使用 Forex Quote（外汇实时报价），多币种资产换算与看板轮询推荐 Batch Forex Quotes（外汇批量报价）或 Full Forex Quote（外汇批量报价）；历史回测支持 Historical Forex Full Chart（外汇历史行情(完整)）日线及 1m/5m/1h 分钟线。

你的需求	推荐接口	选择理由
查询支持的货币对	Forex Currency Pairs外汇货币对清单	先确认代码格式和可用交易对
查询单个货币对最新汇率	Forex Quote外汇实时报价	字段完整的实时汇率入口
批量查询多个货币对	Batch Forex Quotes外汇批量报价	适合汇率面板和组合估值
下载完整日线行情	Historical Forex Full Chart外汇历史行情(完整)	适合回测与历史波动分析
获取分钟级汇率	1-Minute Interval Forex Chart外汇分时K线(1分钟)	适合盘中监控和短周期研究

数据覆盖与参数口径

适用资产：法币货币对
代码格式：通常为 EURUSD、GBPUSD 等，以上游目录为准
时间粒度：最新报价、日线、1/5 分钟和 1 小时
历史范围：因货币对、粒度和套餐而异
市场特性：外汇近 24 小时交易，但周末和节假日可能无更新
核心返回字段：symbol、name、price、changePercentage、dayLow、dayHigh、open、previousClose、timestamp
入库幂等主键：日线按 (symbol, date) 唯一键；分钟线按 (symbol, date) 精确到分钟时间戳去重

调用示例

Python 关键代码

示例场景：获取 EUR/USD 最新汇率 · 对应接口：Forex Quote（外汇实时报价）

Python（核心参数与字段清洗逻辑）

resp = requests.get(
    "https://quote-fmp.com/stable/quote",
    params={"symbol": "EURUSD", "apikey": FMP_KEY},
    timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price（最新价）
df["price"] = pd.to_numeric(df["price"], errors="coerce")

先用货币对目录确认代码。
批量业务请使用 Batch Forex Quotes。

数据注意事项

4 条实盘要点

接入前先调用 Forex Currency Pairs（外汇货币对清单）获取全部合法货币对 symbol（如 EURUSD、USDJPY）及基础/计价货币映射。
多币种汇率看板或跨境结算换算优先使用 Batch Forex Quotes（外汇批量报价）或 Full Forex Quote（外汇批量报价）一次拉齐，减少单对轮询开销。
历史汇率回测按周期长短选择 Historical Forex Full Chart（外汇历史行情(完整)）（日线 OHLCV）或 1-Minute Interval Forex Chart（外汇分时K线(1分钟)） / 1-Hour Interval Forex Chart（外汇分时K线(1小时)）。
外汇市场周末休市（通常美东周五下午至周日下午无新报价），定时任务应结合时间戳 timestamp 判断是否为休市静止快照。