Forex Currency Pairs外汇货币对清单

该接口返回全球外汇市场全部可交易货币对的清单,并说明基础货币与计价货币的含义,便于检索与跟踪汇率行情。

GEThttps://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(基础货币名称)。

Python(核心参数与字段清洗逻辑)
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 校验

/stable/forex-list 针对外汇货币对清单设计(免业务参数),输出 fromCurrency(ARS)等共 5 列,传参时请严格对齐免业务参数示例。

落库主键与口径/stable/forex-list 落库规范:主键取 (symbol),清洗 fromCurrency 文本

/stable/forex-list 共返回 5 列文本/标识属性,入库 UPSERT 主键推荐取 (symbol),并将空字符串 统一归一化为数据库 NULL`。

返回数据

5 个字段

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

字段类型示例值说明
symbolstring"ARSMXN"证券代码
fromCurrencystring"ARS"源币种
toCurrencystring"MXN"目标币种
fromNamestring"Argentine Peso"基础货币名称
toNamestring"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)价格与成交量

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

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