Market Stream Subscription市场行情流订阅
该接口说明 FMP 官方实时流协议中全市场聚合流订阅指令的帧格式与高吞吐消费注意事项。在本站网关（quote-fmp.com）中，推荐使用 /stable/batch-exchange-quote 按交易所一次性拉取全市场股票实时行情截面。
wss://socket.financialmodelingprep.com（官方协议参考 · 本站网关主供 REST /stable/*）数据更新周期
该接口暂无固定更新周期（多为按需更新的参考或静态数据）。
接口说明
- 交易所级全市场聚合流订阅：区别于按单票代码逐一订阅的
quote-subscription，全市场行情流按交易所/市场维度建立聚合推送通道，适合盘中全市场异动扫描、量比监控与实时涨跌榜计算。 - 高吞吐背压控制与队列消费：美股开盘与收盘竞价时段全市场推送帧率极高，消费者线程若在回调内执行同步磁盘 I/O 会导致 TCP 接收缓冲区溢出断连，工程上须先入内存环形队列或按最新价覆盖合并。
- 全交易所截面 REST 替代方案：在本站网关（
quote-fmp.com）中，可按exchange=NASDAQ或NYSE调用/stable/batch-exchange-quote一次性拉取全交易所股票实时价格截面，并搭配涨跌幅异动榜单接口使用。 - 网关支持说明：
quote-fmp.com生产环境仅开放/stable/*REST 端点（WebSocket 暂未开放）；轮询实时价格与成交量请改用 Stock Batch Quote Short（股票批量简明报价）或 Stock Batch Quote（股票批量报价）。 - 跨模块关联接口：Socket.io WebSocket（Socket.IO 实时连接） · Exchange Stock Quotes（交易所全量报价） · Global Exchange Market Hours（全球交易所交易时段） · Stock Batch Quote（股票批量报价）
调用代码示例
Python 关键代码本站网关（quote-fmp.com）仅开放 /stable/* REST 接口（WebSocket 暂未开放）；上方展示通过 /stable/batch-exchange-quote 一次性拉取纳斯达克全市场股票实时行情截面的可运行代码。
session = requests.Session()
# 本站网关（quote-fmp.com）当前对客主供全量 REST 接口（/stable/*），WebSocket 流暂未开放
resp = session.get(
"https://quote-fmp.com/stable/batch-exchange-quote",
params={"exchange": "NASDAQ", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 官方全市场行情聚合流订阅指令参考：
# market_sub = {"event": "subscribe", "data": {"ticker": "*"}}参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 网关 REST 替代方案：按纳斯达克（NASDAQ）拉取全所股票实时快照 | GET /stable/batch-exchange-quote?exchange=NASDAQ | 单次请求返回 NASDAQ 全部挂牌标的的实时价格、涨跌幅与成交量，可用于全市场盘中异动扫描。 |
| 网关 REST 替代方案：切换纽约证券交易所（NYSE）拉取主板全量行情 | GET /stable/batch-exchange-quote?exchange=NYSE | 一次拉齐纽交所主板全部股票的当期盘口快照，与 NASDAQ 结果合并即可覆盖美股核心市场。 |
| 官方流协议参考：使用通配符订阅全市场实时推送流 | {"event": "subscribe", "data": {"ticker": "*"}} | 官方流协议中用于开启全市场级别的高吞吐逐笔推送，消费端需具备异步队列防背压能力。 |
在本站网关同步全美股盘中行情时，切勿遍历股票代码表发数千次单股请求；只需对 /stable/batch-exchange-quote 分别传入 exchange=NASDAQ、NYSE、AMEX 共 3 次请求，即可拿齐数千只美股的最新截面。
美东时间 09:30 开盘与 15:50–16:00 收盘窗口内，全市场成交报文密度是平时的 10 倍以上。相比容易因消费阻塞而断连的 WebSocket 流，使用 /stable/batch-exchange-quote 按固定周期拉取截面具有恒定可控的解析开销。
返回数据
25 个字段本接口示例响应共包含 25 个字段（数值型 15 个，文本/日期/布尔型 10 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "XKMYA.IS" | 证券代码 |
name | string | "BIST Kimya Petrol Plastik" | 名称 |
price | number | 13057.45 | 最新价 |
changesPercentage | number | 0.35246 | 涨跌幅（%） |
change | number | 45.86 | 涨跌额 |
dayLow | number | 13031.22 | 当日最低价 |
dayHigh | number | 13085.88 | 当日最高价 |
yearHigh | number | 13085.88 | 52 周最高 |
yearLow | number | 13011.59 | 52 周最低 |
marketCap | number | 0 | 总市值 |
priceAvg50 | number | 13245.1474 | 50 日均价 |
priceAvg200 | number | 11936.814 | 200 日均价 |
exchange | string | "INDEX" | 交易所代码 |
volume | number | 0 | 成交量 |
avgVolume | number | 0 | 平均成交量 |
open | number | 13051.14 | 开盘价 |
previousClose | number | 13011.59 | 昨收价 |
eps | null | null | 每股收益 |
pe | null | null | 市盈率（P/E） |
earningsAnnouncement | null | null | 财报公布日期 |
sharesOutstanding | null | null | 发行在外股本 |
timestamp | number | 1766045220 | 时间戳 |
range | string | "13011.59 - 13085.88" | 区间 |
type | string | "index" | 类型（如买入/卖出） |
updatedAt | string | "2025-12-18T08:22:00.504Z" | 更新时间 |
查看响应数据示例（原始 JSON）
{
"symbol": "XKMYA.IS",
"name": "BIST Kimya Petrol Plastik",
"price": 13057.45,
"changesPercentage": 0.35246,
"change": 45.86,
"dayLow": 13031.22,
"dayHigh": 13085.88,
"yearHigh": 13085.88,
"yearLow": 13011.59,
"marketCap": 0,
"priceAvg50": 13245.1474,
"priceAvg200": 11936.814,
"exchange": "INDEX",
"volume": 0,
"avgVolume": 0,
"open": 13051.14,
"previousClose": 13011.59,
"eps": null,
"pe": null,
"earningsAnnouncement": null,
"sharesOutstanding": null,
"timestamp": 1766045220,
"range": "13011.59 - 13085.88",
"type": "index",
"updatedAt": "2025-12-18T08:22:00.504Z"
}常见问题解答（FAQ）
2 个问题除了拉取全交易所快照，有没有直接返回当日涨幅榜和成交活跃榜的 REST 接口？
有。如果您的目标是捕捉盘中领涨、领跌或放量异动股，可直接调用市场表现类别下的 Biggest Stock Gainers（涨幅榜）、Biggest Stock Losers（跌幅榜）和 Top Traded Stocks（成交活跃榜）。
/stable/batch-exchange-quote 支持哪些交易所代码（exchange）？
支持全球主流交易所短码，如美股 NASDAQ、NYSE、AMEX，港股 HKSE，伦交所 LSE，多伦多 TSX 等。完整代码表可通过 Available Exchanges（可用交易所清单）查询。
同模块相关接口对比
Websocket本接口路径 market-stream-subscription，无必填参数。 同一模块「Websocket」下共 6 个接口，下表列出其余 5 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 标准 WebSocketStandard WebSocket | standard-websocket | 官方原生 WebSocket 实时行情通道的握手流程与登录认证帧格式规范 |
| 报价订阅Quote Subscription | quote-subscription | 官方实时流协议中发起单票或多票实时报价订阅的指令载荷与逐笔成交、盘口帧结构 |
| 取消单只标的订阅Unsubscribe Ticker | unsubscribe-ticker | 官方实时流协议中取消指定标的报价订阅的退订指令结构与客户端订阅列表维护方式 |
| 取消市场行情流订阅Unsubscribe Market Stream | unsubscribe-market-stream | 官方实时流协议中关闭全市场行情聚合推送通道的退订指令格式与连接释放规范 |
| 心跳事件Heartbeat Event | heartbeat-event | 官方实时流协议中服务端周期性下发的 heartbeat 保活事件帧格式与半开死连接超时重连机制 |