Quote Subscription报价订阅
该接口文档说明官方实时流协议中发起单票或多票实时报价订阅的指令载荷与逐笔成交、盘口帧结构。在本站网关生产环境中，推荐直接调用批量股票报价或批量简明报价 REST 接口一次性拉取多只标的的实时行情快照。
wss://socket.financialmodelingprep.com（官方协议参考 · 本站网关主供 REST /stable/*）数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 单票与多标的订阅指令格式：鉴权通过后发送
{"event":"subscribe","data":{"ticker":["aapl","msft"]}}即可订阅实时行情流，服务端将持续推送逐笔成交（type="T"）与买卖盘口（type="Q"）事件帧。 - 逐笔成交与盘口报价字段区分：消费实时流时需严格区分最新成交价（
lp）、成交量（ls）与买一价/卖一价（bp/ap）；高频时段推送密度极高，客户端应采用异步队列解耦网络接收与落库计算。 - REST 批量报价高频轮询方案：在本站网关（
quote-fmp.com）下，推荐直接调用/stable/batch-quote或/stable/batch-quote-short一次性拉取自选股池的price、changePercentage、volume与日内高低点快照。 - 网关支持说明：
quote-fmp.com生产环境仅开放/stable/*REST 端点（WebSocket 暂未开放）；轮询实时价格与成交量请改用 Stock Batch Quote Short（股票批量简明报价）或 Stock Batch Quote（股票批量报价）。 - 关联数据线接口：Socket.io WebSocket（Socket.IO 实时连接） · Stock Batch Quote（股票批量报价） · Stock Batch Quote Short（股票批量精简报价） · Exchange Stock Quotes（交易所全量报价）
调用代码示例
Python 关键代码本站网关（quote-fmp.com）仅开放 /stable/* REST 接口（WebSocket 暂未开放）；上方展示使用 /stable/batch-quote-short 极速获取多只半导体与科技股最新价的可运行代码及官方 subscribe 报文结构。
session = requests.Session()
# 本站网关（quote-fmp.com）当前对客主供全量 REST 接口（/stable/*），WebSocket 流暂未开放
resp = session.get(
"https://quote-fmp.com/stable/batch-quote-short",
params={"symbols": "AAPL,NVDA,AMD,AVGO", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 官方单票/多票实时报价订阅（subscribe）JSON 报文参考：
# sub_payload = {"event": "subscribe", "data": {"ticker": ["aapl", "nvda", "amd"]}}参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 网关 REST 替代方案：极简批量报价（仅返回 price / change / volume） | GET /stable/batch-quote-short?symbols=AAPL,NVDA,AMD,AVGO | 响应载荷极小，单次请求返回多只标的的实时成交价、涨跌额与成交量，适合高频自选股列表刷屏。 |
| 网关 REST 替代方案：完整批量报价（含市值、PE、50/200 日均线） | GET /stable/batch-quote?symbols=AAPL,NVDA,AMD,AVGO | 一次请求返回 19 个完整盘口与估值字段，兼顾实时盯盘与日内基本面监控。 |
| 官方流协议参考：发送 event=subscribe 订阅多只标的逐笔流 | {"event": "subscribe", "data": {"ticker": ["aapl", "nvda", "amd"]}} | 在官方流通道中增量添加多个小写 ticker，服务端将持续下发最新成交帧（T）与盘口报价帧（Q）。 |
在本站网关中，针对几十只自选股的高频刷新场景，调用 /stable/batch-quote-short?symbols=... 比单票循环调用 /stable/quote 节省 95% 以上的请求次数，且返回结构直接适配 DataFrame。
官方流推送混合了三类报文：type='T' 为真实撮合成交（含 lp 最新价、ls 单笔成交量），type='Q' 为盘口挂单更新（含 ap/as 卖一与 bp/bs 买一），type='B' 为异常撤单。合成实时 K 线时仅能累加 type='T' 的成交量。
返回数据
22 个字段本接口示例响应共包含 22 个字段（数值型 18 个，文本/日期/布尔型 4 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
name | string | "Apple Inc." | 名称 |
price | number | 239.62 | 最新价 |
changesPercentage | number | 1.23363 | 涨跌幅（%） |
change | number | 2.92 | 涨跌额 |
dayLow | number | 236.3235 | 当日最低价 |
dayHigh | number | 241.22 | 当日最高价 |
yearHigh | number | 260.1 | 52 周最高 |
yearLow | number | 169.21 | 52 周最低 |
marketCap | number | 3556056617328.9995 | 总市值 |
priceAvg50 | number | 221.5888 | 50 日均价 |
priceAvg200 | number | 221.55185 | 200 日均价 |
exchange | string | "NASDAQ" | 交易所代码 |
volume | number | 20490499 | 成交量 |
avgVolume | number | 56040420.3 | 平均成交量 |
open | number | 237.175 | 开盘价 |
previousClose | number | 236.7 | 昨收价 |
eps | number | 7.26 | 每股收益 |
pe | number | 33.01 | 市盈率（P/E） |
earningsAnnouncement | string | "2025-10-30T20:00:00.000+0000" | 财报公布日期 |
sharesOutstanding | number | 14840399872 | 发行在外股本 |
timestamp | number | 1758032977 | 时间戳 |
查看响应数据示例（原始 JSON）
{
"symbol": "AAPL",
"name": "Apple Inc.",
"price": 239.62,
"changesPercentage": 1.23363,
"change": 2.92,
"dayLow": 236.3235,
"dayHigh": 241.22,
"yearHigh": 260.1,
"yearLow": 169.21,
"marketCap": 3556056617328.9995,
"priceAvg50": 221.5888,
"priceAvg200": 221.55185,
"exchange": "NASDAQ",
"volume": 20490499,
"avgVolume": 56040420.3,
"open": 237.175,
"previousClose": 236.7,
"eps": 7.26,
"pe": 33.01,
"earningsAnnouncement": "2025-10-30T20:00:00.000+0000",
"sharesOutstanding": 14840399872,
"timestamp": 1758032977
}常见问题解答（FAQ）
2 个问题在本站网关中，/stable/batch-quote 和 /stable/batch-quote-short 该怎么选？
如果只需要实时刷新价格（price）、涨跌（change）和当日累计成交量（volume），选 Stock Batch Quote Short（股票批量精简报价）响应最快；如果还需要当日高低价、前收盘价、市值（marketCap）和年高低点，选 Stock Batch Quote（股票批量报价）。
盘前（04:00–09:30 ET）和盘后（16:00–20:00 ET）的实时报价用哪个 REST 接口查？
主交易时段以外的扩展时段行情，请调用同属 Quote 类别的 Batch Aftermarket Trade（盘后批量成交）与 Batch Aftermarket Quote（盘后批量报价）。
同模块相关接口对比
Websocket本接口路径 quote-subscription，无必填参数。 同一模块「Websocket」下共 6 个接口，下表列出其余 5 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 标准 WebSocketStandard WebSocket | standard-websocket | 官方原生 WebSocket 实时行情通道的握手流程与登录认证帧格式规范 |
| 市场行情流订阅Market Stream Subscription | market-stream-subscription | FMP 官方实时流协议中全市场聚合流订阅指令的帧格式与高吞吐消费注意事项 |
| 取消单只标的订阅Unsubscribe Ticker | unsubscribe-ticker | 官方实时流协议中取消指定标的报价订阅的退订指令结构与客户端订阅列表维护方式 |
| 取消市场行情流订阅Unsubscribe Market Stream | unsubscribe-market-stream | 官方实时流协议中关闭全市场行情聚合推送通道的退订指令格式与连接释放规范 |
| 心跳事件Heartbeat Event | heartbeat-event | 官方实时流协议中服务端周期性下发的 heartbeat 保活事件帧格式与半开死连接超时重连机制 |