批量刷新关注标的的价格、涨跌幅和成交量。
Quote(实时行情)
此类接口提供证券的最新价格信息,包括单标的的完整报价、字段更少的精简报价、一次查多只标的的批量报价、盘中与盘后的成交和报价,以及按交易所或资产类别取回的全市场快照清单。做自选股面板、下单前取价、全市场扫描都从这里开始;需要历史 K 线或分钟数据,请转到股票行情。
典型使用场景
4 个场景跟踪美股常规交易时段之外的报价与成交。
按交易所或资产类别获取行情快照并筛选异动。
在同一数据入口中组合股票、指数、外汇和加密报价。
接口怎么选?
6 项选型对照实时报价类别解决的是“现在价格是多少、一次要查多少标的、是否需要盘前盘后数据”。如果需要历史 K 线或分钟数据,应转到历史行情 API。
股票代码格式和实际可用市场因交易所、标的与套餐而异。本站将美股作为主要示例,同时保留港股、A 股、日股、欧股及多资产的验证入口。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 查询一只股票的完整最新报价 | Stock Quote股票报价 | 字段最完整,适合作为实时行情接入起点 |
| 只需要价格和成交量等精简字段 | Stock Quote Short精简报价 | 返回体更小,适合高频轻量查询 |
| 一次查询多只股票 | Stock Batch Quote股票批量报价 | 减少逐标的请求,适合自选股和看板 |
| 查询盘后报价或成交 | Aftermarket Quote盘后报价 | 专门用于常规交易时段之外的行情 |
| 按交易所获取全市场快照 | Exchange Stock Quotes交易所全量报价 | 适合市场扫描和本地快照同步 |
| 获取外汇、加密或指数全量报价 | Full Forex Quote外汇批量报价 | 按资产类别选择对应的全量 Quote 接口 |
数据覆盖与参数口径
- 适用资产:股票、ETF、基金、指数、外汇、加密货币、商品
- 主要市场:美股及部分全球交易所;非美市场按代码和样例验证
- 查询方式:单证券代码、批量代码或交易所
- 数据时点:最新快照;实时性和延迟取决于市场与套餐
- 不适用:历史 K 线、分钟行情和复权序列请使用 Chart 类接口
- 验证原则:不使用“全球全部实时”等未经逐市场证明的绝对表述
调用示例
Python 关键代码示例场景:获取 AAPL 最新报价 · 对应接口:Stock Quote(股票报价)
resp = requests.get(
"https://quote-fmp.com/stable/quote",
params={"symbol": "AAPL", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 数值化核心指标列 price(最新价)
df["price"] = pd.to_numeric(df["price"], errors="coerce")- 将 AAPL 替换为已验证的市场代码即可测试其他交易所。
- 需要多标的时优先使用 Batch Quote,避免循环请求。
数据注意事项
4 条实盘要点- 记录
symbol、exchange和timestamp抓取时间,保证 Stock Quote(股票报价) 与 Stock Batch Quote(股票批量报价) 的行情快照可追溯。 - 多标的轮询优先使用 Stock Batch Quote(股票批量报价) 或 Exchange Stock Quotes(交易所全量报价),并为超时与限流(HTTP 429)设置指数退避重试。
- 盘前盘后时段请调用 Aftermarket Quote(盘后报价) 或 Aftermarket Trade(盘后逐笔成交),常规报价接口在闭市后返回的是当日收盘快照。
- 跨市场接入前先用 Global Exchange Market Hours(全球交易所交易时段) 核对交易所时区与开闭市状态,避免休市期间高频空跑。
常见问题
4 个问题Quote 接口是实时还是延迟?
接口返回最新可用快照,但具体实时性取决于交易所授权、资产类别和套餐。接入前应使用目标标的实测时间戳。
Quote 与历史行情 API 有什么区别?
Quote 用于当前快照;历史行情 API 返回按日或分钟排列的时间序列,适合 K 线、回测和技术分析。
如何一次查询多只股票?
使用 Batch Quote 类接口。它比逐只循环调用更适合自选股列表、行情面板和定时同步。
是否支持港股、A 股和其他市场?
FMP 可查询部分全球市场标的,但覆盖度因市场、接口和年份而异。请使用目标代码验证,并以覆盖说明中的最近实测为准。
接口一览(16个)
3 个功能模块Single Quote
5 个接口该接口返回个股的实时行情数据:最新价格、涨跌与成交量,数据实时更新。
/stable/quote该接口返回单只股票的极简实时行情快照,仅保留最新成交价、涨跌额与当日累计成交量三个核心字段,响应体积极小,适合高频看板刷新。
/stable/quote-short该接口返回盘后交易时段的实时成交明细:成交价、成交规模与成交时间戳等关键信息,用于追踪常规交易时段之外的市场活动。
/stable/aftermarket-trade该接口返回正常交易时段之外的股票报价:买卖价、成交量等关键数据实时更新,可用于盘后行情监控和次日交易策略的制定。
/stable/aftermarket-quote该接口一次返回单只股票在 1D、5D、1M、3M、6M、YTD、1Y、3Y、5Y、10Y 及历史最长区间的累计涨跌幅百分比,无需拉取日线即可直接用于动量因子打分。
/stable/stock-price-changeBatch
4 个接口该接口单次请求返回多只股票的实时报价:现价、成交量、日内最高最低价、50 日与 200 日均线等详细数据一并获取,适合跟踪大型投资组合或同时监控多只股票。
/stable/batch-quote该接口一次请求返回多只股票的短格式实时报价:只取现价、涨跌与成交量等关键数据,快速掌握市场动向。
/stable/batch-quote-short该接口一次请求返回多只股票的盘后交易明细:成交价、成交量与成交时间戳可同时跟踪多家公司,用于盘后行情分析与次日策略准备。
/stable/batch-aftermarket-trade该接口一次请求返回多只股票的盘后实时报价:买卖价、成交量等关键盘后数据一并获取,适合同时跟踪一篮子股票的盘后行情。
/stable/batch-aftermarket-quoteBatch List
7 个接口该接口一次返回指定交易所所有上市股票的实时报价,包括价格、成交量与涨跌信息,覆盖整个交易所的交易动态。
/stable/batch-exchange-quote该接口返回各类公募基金的实时价格与表现数据,包括最新价格、涨跌变化等关键信息,便于监控基金行情。
/stable/batch-mutualfund-quotes该接口返回各 ETF 的实时价格与表现数据,包括最新价格、涨跌幅等关键行情信息,便于监控与比较多个 ETF。
/stable/batch-etf-quotes该接口一次请求即可返回多种大宗商品的实时行情:最新价格、涨跌变化、成交量等关键指标,适合需要同时监控多个商品品种的投资者、交易员和分析师。
/stable/batch-commodity-quotes该接口一次请求返回多种加密货币的实时行情:最新价格、涨跌变化与成交量,适合需要同时跟踪多个数字资产价格的投资者、交易员和分析师。
/stable/batch-crypto-quotes该接口一次请求返回多个货币对的实时报价:价格、涨跌与成交量一并获取,可用于持续跟踪全球汇率与不同市场的价格波动。
/stable/batch-forex-quotes该接口一次请求返回全部可用股指的实时报价:从标普 500、道琼斯、纳斯达克等主要基准指数到小众及区域指数,方便用户快速总览多个指数的市场表现。
/stable/batch-index-quotes