Forex Quote外汇实时报价
该接口返回货币对的实时汇率报价,包括当前价格、日内与年度高低点、涨跌幅以及 50 日和 200 日均线等关键数据。
GET
https://quote-fmp.com/stable/quote?symbol=EURUSD数据更新周期
Real-Time · 实时更新
接口说明
- 实时外汇报价:获取 EUR/USD 等各货币对最新的汇率与价格更新,传入
symbol后可汇总name(名称)、price(最新价)与changePercentage(涨跌幅(%)) 等要素,可直接嵌入日常投研监控脚本。 - 详细价格信息:获取当前价、日内高低点、年度高低点和涨跌幅等关键数据,抽取
price(最新价)与changePercentage(涨跌幅(%)) 等关键维度,能够显著提升样本筛选与标的池初筛效率。 - 跟踪市场走势:查看开盘价、收盘价以及 50 日和 200 日均线,全面把握市场趋势,在搭建投研工作流时,建议配合「外汇简要报价」同步拉取关联截面数据。
- 配套投研接口:Forex Currency Pairs(外汇货币对清单) · Historical Forex Light Chart(外汇历史行情(轻量)) · COT Report(COT 持仓报告) · Forex News(外汇新闻)
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | EURUSD | 6 位国际外汇货币对代码(不带斜杠),例如 EURUSD(欧元兑美元)、USDJPY(美元兑日元)、GBPUSD(英镑兑美元)。 |
调用代码示例
Python 关键代码/stable/quote 专供外汇实时报价查询(必填 symbol),返回列表含 name(名称)、price(最新价)、changePercentage(涨跌幅(%))(如 name=EUR/USD)。
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")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按代码 EURUSD 提取外汇实时报价截面 | symbol=EURUSD | 对 /stable/quote 传入必填项 EURUSD,读取 name、price、changePercentage(name=EUR/USD)共 17 个字段。 |
| 切换主力品种 USDJPY(美元兑日元)拉取外汇实时报价 | symbol=USDJPY | 改传 symbol=USDJPY 访问 /stable/quote,提取 美元兑日元 的 name、price、changePercentage 做跨品种比对。 |
参数与空值防守/stable/quote 容错处理:未命中空响应与 name 采集
/stable/quote 提供外汇实时报价的 name(名称)等共 17 列;遇到冷门代码或未收录条件返回空数组时应做跳过容错。
落库主键与口径外汇实时报价(/stable/quote):price 数值转型与 (symbol, exchange, name) 约束
针对 /stable/quote 输出的 name(EUR/USD)与 price(1.15284),建表时请用 (symbol, exchange, name) 作主键约束,并显式处理 null 字段。
返回数据
17 个字段本接口示例响应共包含 17 个字段(数值型 13 个,文本/日期/布尔型 4 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "EURUSD" | 证券代码 |
name | string | "EUR/USD" | 名称 |
price | number | 1.15284 | 最新价 |
changePercentage | number | 0.55071 | 涨跌幅(%) |
change | number | 0.006314 | 涨跌额 |
volume | number | 146872 | 成交量 |
dayLow | number | 1.1439 | 当日最低价 |
dayHigh | number | 1.1538 | 当日最高价 |
yearHigh | number | 1.20236 | 52 周最高 |
yearLow | number | 1.13254 | 52 周最低 |
marketCap | null | null | 总市值 |
priceAvg50 | number | 1.14891 | 50 日均价 |
priceAvg200 | number | 1.163 | 200 日均价 |
exchange | string | "FOREX" | 交易所代码 |
open | number | 1.14666 | 开盘价 |
previousClose | number | 1.14653 | 昨收价 |
timestamp | number | 1785430798 | 时间戳 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "EURUSD",
"name": "EUR/USD",
"price": 1.15284,
"changePercentage": 0.55071,
"change": 0.006314,
"volume": 146872,
"dayLow": 1.1439,
"dayHigh": 1.1538,
"yearHigh": 1.20236,
"yearLow": 1.13254,
"marketCap": null,
"priceAvg50": 1.14891,
"priceAvg200": 1.163,
"exchange": "FOREX",
"open": 1.14666,
"previousClose": 1.14653,
"timestamp": 1785430798
}
]常见问题解答(FAQ)
2 个问题对比外汇实时报价与 外汇简要报价:/stable/quote 的调用方式和返回字段有哪些独特之处?
外汇实时报价(/stable/quote,必填 symbol)聚焦于提供 name、price 等 17 个字段;同属「Quotes」的 Forex Short Quote(外汇简要报价)则提供 4 个字段。
对接外汇实时报价端点 /stable/quote 时,大跨度回溯与日常增量刷新分别怎么传参?
对接 外汇实时报价 时可在 /stable/quote 中指定 symbol(跨市场代码须保留后缀);配合连接池复用与 15~30 秒超时设置,能大幅提升 name 的同步吞吐率。
同模块相关接口对比
Quotes本接口路径 /stable/quote,必填参数 symbol。 同一模块「Quotes」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。
需要稳定访问 外汇实时报价 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月