Forex Currency Pairs外汇货币对清单
该接口返回全球外汇市场全部可交易货币对的清单,并说明基础货币与计价货币的含义,便于检索与跟踪汇率行情。
https://quote-fmp.com/stable/forex-list数据更新周期
N/A · 不适用固定周期
接口说明
- 货币对识别:轻松识别外汇市场中可交易的各种货币对。货币对由基础货币和计价货币组成,其报价表示购买一单位基础货币所需的计价货币数量。
- 表现跟踪:跟踪不同货币对随时间的表现,对希望监测市场趋势和汇率走势的投资者和交易员至关重要,对照
toCurrency(目标币种)与fromName(基础货币名称) 等历史记录,可检验策略信号在不同市场周期下的稳健性。 - 辅助交易决策:利用货币对清单的全面数据支持外汇交易决策,理解货币对的运行规律,制定契合市场行情的策略,适合纳入每日定时同步管道,为策略信号生成与风险监控提供稳定数据支撑。
- 上下游关联接口:Historical Forex Full Chart(外汇历史行情(完整)) · 1-Minute Interval Forex Chart(外汇分时K线(1分钟)) · Forex News(外汇新闻) · Economics Indicators(经济指标数据)
调用代码示例
Python 关键代码对接 /stable/forex-list(外汇货币对清单,仅 apikey),从 DataFrame 可直接读取 fromCurrency(源币种)、toCurrency(目标币种)、fromName(基础货币名称)。
resp = requests.get(
"https://quote-fmp.com/stable/forex-list",
params={"apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 外汇货币对清单 核心列:symbol, fromCurrency, toCurrency, fromName
df = df[["symbol", "fromCurrency", "toCurrency", "fromName"]].dropna(how="all")参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 一次性拉取全量外汇货币对清单初始化本地主表 | GET /stable/forex-list(免参数) | 该接口不吃 Query 条件:请求 /stable/forex-list 直接下发全表 5 列,fromCurrency、toCurrency、fromName 全在其中。 |
| 以 symbol 为唯一键覆盖写入,避免全表重复 | GET /stable/forex-list → upsert on symbol | 落库键选 symbol(如 ARSMXN),5 列逐行覆盖;同模块没有带参接口,想补单条只能再拉一次全表。 |
| 落库后自检:symbol 唯一性与 fromCurrency 空值率 | GET /stable/forex-list → count(distinct symbol) / null_ratio(fromCurrency) | 本表共 5 列。落库后先比对 count(distinct symbol) 与总行数确认无重复;再统计 fromCurrency(样本 ARS)的空值比例,判断该批次是否拉到完整截面。 |
/stable/forex-list 针对外汇货币对清单设计(免业务参数),输出 fromCurrency(ARS)等共 5 列,传参时请严格对齐免业务参数示例。
/stable/forex-list 共返回 5 列文本/标识属性,入库 UPSERT 主键推荐取 (symbol),并将空字符串 统一归一化为数据库 NULL`。
返回数据
5 个字段本接口示例响应共包含 5 个字段(数值型 0 个,文本/日期/布尔型 5 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "ARSMXN" | 证券代码 |
fromCurrency | string | "ARS" | 源币种 |
toCurrency | string | "MXN" | 目标币种 |
fromName | string | "Argentine Peso" | 基础货币名称 |
toName | string | "Mexican Peso" | 计价货币名称 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "ARSMXN",
"fromCurrency": "ARS",
"toCurrency": "MXN",
"fromName": "Argentine Peso",
"toName": "Mexican Peso"
}
]常见问题解答(FAQ)
2 个问题为什么「Forex」同时提供外汇货币对清单(/stable/forex-list)和 外汇实时报价(/stable/quote)两个端点?
/stable/forex-list(外汇货币对清单,免业务参数)专门针对 fromCurrency(源币种)与 fromName(基础货币名称)等 5 个字段建模;若要结合 Forex Quote(外汇实时报价),可再调 /stable/quote(必填 symbol)。
在量化生产环境中,如何高效拉取外汇货币对清单(/stable/forex-list)的历史序列或批量截面?
建议直接请求无参端点 /stable/forex-list 拉取全表快照并缓存;拿到 fromCurrency(源币种)等数据后,先校验 len(data) > 0 再送入下游清洗管道。
同分类关联接口对比
外汇数据本接口路径 /stable/forex-list(所属子模块「Forex」仅此 1 个接口),无必填参数。 下表列出同属「外汇数据」大类下的 6 个关联接口,方便横向对比与上下游联动:
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 外汇实时报价Forex Quote | /stable/quote | 货币对的实时汇率报价,包括当前价格、日内与年度高低点、涨跌幅以及 50 日和 200 日均线等关键数据 |
| 外汇简要报价Forex Short Quote | /stable/quote-short | 以精简格式返回货币对的实时汇率、最新涨跌幅和成交量,适合需要快速查看行情、做快速决策的场景 |
| 外汇批量报价Batch Forex Quotes | /stable/batch-forex-quotes | 一次请求返回多个货币对的实时报价,价格、涨跌与成交量一并获取 |
| 外汇历史行情(轻量)Historical Forex Light Chart | /stable/historical-price-eod/light | 各货币对的历史日线价格,适合跟踪长期价格趋势、回测策略和比较不同货币对的表现 |
| 外汇历史行情(完整)Historical Forex Full Chart | /stable/historical-price-eod/full | 大量货币对的历史日线数据,包括开高低收(OHLC)价格、成交量、VWAP 及涨跌幅 |
| 外汇分时K线(1分钟)1-Minute Interval Forex Chart | /stable/historical-chart/1min | 高频日内数据,返回货币对每分钟的开高低收(OHLC)价格与成交量 |