Massive(原 Polygon.io)是什么?美股、期权与期货 API 套餐价格与接入指南
搭建美股日内高频回测、OPRA 期权链监控或跨资产实时行情系统时,免费爬虫(如 yfinance)或日终报表接口常在三处卡壳:缺少纳秒级逐笔成交(Trades)与全美最优买卖盘口(NBBO Quotes)、缺历史期权链(IV 与 Greeks)及期货逐笔行情、且日线均价常以四价算术均值冒充真实成交量加权均价(VWAP)。Massive(原 Polygon.io) 正是针对市场微观结构与衍生品场景构建的行情数据引擎。
本文基于 Massive数据源中文站 梳理的 9 大金融资产类别、4 种取数通道、21 个概览页、211 篇结构化接口文档与 4,835 个中文化返回字段,结合截至 2026 年 11 月 16 日实盘拉取的 AAPL、NVDA、SPY、TSLA 日线、分钟线与实时 NBBO 盘口报文,拆解 Massive 的接口体系、核心口径、Python 代码与套餐规则。
Massive 与 Polygon.io 是什么关系?9 大金融资产与 4 种数据通道的全景版图
Massive 是美股与衍生品行情数据商 Polygon.io 品牌升级后的新名称。存量量化项目的底层 REST 路由(如聚合 K 线 /v2/aggs/ticker/...、逐笔成交 /v3/trades/...、报价 /v3/quotes/...、快照 /v2/snapshot/... 与 /v3/snapshot/...)、范围过滤算子(.gte / .lte)、游标分页字段(next_url)及 WebSocket 协议均完全向后兼容,旧脚本无需重写。
Massive 采用 「9 大金融资产 × 4 种交付通道」 二维架构,211 篇文档含 150 篇 REST API 接口、28 篇 WebSocket 实时频道 与 33 篇 Flat Files(S3 按日历史归档文件)。因多资产共用统一聚合路由,服务端严格靠标的代码前缀区分账本(漏写前缀会返回 HTTP 200 空数组)。下表汇总 9 大资产覆盖范围、前缀规则与站内入口:
| 资产类别 | 核心数据覆盖与底层行情源 | 标的前缀与传参示例 | 站内文档入口 |
|---|---|---|---|
| 1. 美股(Stocks) | 全美交易所(CTA/UTP SIP 合并流)逐笔成交、NBBO 报价、秒/分钟/日聚合 K 线、快照、公司行动、SEC 申报与标准三表 | 无前缀大写代码(多类别股用点号,如 BRK.A、BRK.B) | 美股数据主页 · 美股 REST 概览 · 美股 WS 概览 |
| 2. 期权(Options) | OPRA 全美期权合约参考库、整条期权链快照(含隐含波动率 IV 与 Greeks)、逐笔成交、最优报价与历史 K 线 | O: 前缀 + 21 位 OCC 编码(如 O:SPY251219C00600000) | 期权数据主页 · 期权 REST 概览 · Option Chain Snapshot(期权链快照接口) |
| 3. 期货(Futures) | 芝商所集团(CME / CBOT / NYMEX / COMEX)股指、能源、金属、农产品与利率期货合约目录、交易时间表、K 线与逐笔盘口 | 品种码 + 月份字母码 F~Z + 年尾数(如 ESZ5、CLF6) | 期货数据主页 · 期货 REST 概览 · Contracts(期货合约列表接口) |
| 4. 指数(Indices) | 标普 500、纳斯达克 100、道琼斯、VIX 恐慌指数等全球主流指数的实时点位流、快照与分钟/日级历史序列 | I: 前缀(如 I:SPX、I:NDX、I:VIX;无成交量 v) | 指数数据主页 · 指数 REST 概览 · Custom Bars (OHLC)(指数自定义 K 线接口) |
| 5. 外汇(Currencies) | 全球 1750+ 货币对机构报价源、BBO 最优买卖报价、实时汇率换算、快照与多周期聚合 K 线 | REST 冠 C:(如 C:EURUSD);WS 用斜杠 C.EUR/USD | 外汇数据主页 · 外汇 REST 概览 · Custom Bars (OHLC)(外汇自定义 K 线接口) |
| 6. 加密货币(Crypto) | 主流加密交易所 7×24 小时币对逐笔成交、报价、秒/分钟/日聚合 K 线与跨所公允价值(FMV) | REST 冠 X:(如 X:BTCUSD);WS 用连字符 XT.BTC-USD | 加密数据主页 · 加密 REST 概览 · Custom Bars (OHLC)(加密自定义 K 线接口) |
| 7. 宏观经济(Economy) | 美联储与美国官方发布的国债收益率曲线、CPI/PCE 通胀、通胀预期与非农就业时间序列 | 无标的前缀,按日期算子 date.gte / date.lte 过滤 | 宏观数据主页 · 宏观 REST 概览 · Treasury Yields(国债收益率接口) |
| 8. 另类数据(Alternative) | 欧洲消费者支出按商户聚合序列与商户到母公司、股票代码、行业板块的层级映射(回溯至 2016 年) | 按商户、国家码或关联上市公司代码检索 | 另类数据主页 · Merchant Aggregates(商户消费聚合接口) · Merchant Hierarchy(商户层级映射接口) |
| 9. 合作方(Partners) | 同源鉴权接入 Benzinga 分析师评级/目标价/财报超预期、ETF Global 持仓敞口及 TMX 公司事件 | 直接传大写正股或 ETF 代码(如 AAPL、SPY) | 合作方数据主页 · Analyst Ratings(分析师评级接口) · 全站资产总览 |
四种通道分工明确:Flat Files 批量文件 用于冷启动按日下载 .csv.gz 历史分钟线与 Tick 归档;WebSocket 实时推送 用于盘中订阅逐笔(T.*)、报价(Q.*)与聚合流(AM.* / A.*);REST 查询接口 用于拉取参考字典、财报与断线补数;AI 与 MCP 工具 则借助站内 /llms.txt 与 数据口径与编码规范手册 辅助大模型生成零报错代码。
为什么做盘中微观结构、期权链与期货回测,开源爬虫和传统日线接口顶不上?
当策略从日线均线延伸至日内动量、VWAP 算法执行评估、末日期权(0DTE)波动率曲面或股指期货展期回测时,基础日终接口会出现明显盲区。以下结合实盘数据拆解四项核心能力。
1. 日线与分钟线真成交量加权 VWAP(vw)、碎股成交量与撮合笔数(n)
不少日线接口虽返回 vwap 字段,底层却用开高低收四价简单算术均值 (O+H+L+C)/4 替代。一旦盘中出现单边放量行情,简单均价便会偏离真实换手重心。
Massive 的 Custom Bars (OHLC)(自定义 K 线接口,GET /v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to},历史始于 2003 年 9 月 10 日)按合资格逐笔成交总金额除以总成交股数计算真实 vw,并返回含碎股小数位的成交量(v)与撮合笔数(n)。以下为按官方 /v2/aggs 标准字段结构整理的 NVDA 在 2026-11-12 与 2026-11-13 实盘日线数据(数据快照截至 2026-11-16):
{
"ticker": "NVDA",
"adjusted": true,
"resultsCount": 2,
"status": "OK",
"results": [
{ "t": 1794546000000, "o": 169.905, "h": 170.0, "l": 158.39, "c": 162.85, "v": 365796552.394448, "vw": 162.4145, "n": 4997505 },
{ "t": 1794459600000, "o": 151.005, "h": 167.14, "l": 148.8, "c": 166.19, "v": 747707648.398177, "vw": 161.642, "n": 9573490 }
]
}
下表列示 AAPL、NVDA、SPY、TSLA 在 2026-11-11 至 2026-11-13 期间的开高低收四价(o/h/l/c)、含碎股成交量(v)、撮合笔数(n)、真实成交量加权均价(vw)与四价均值 (o+h+l+c)/4 的差值,以及按 vw × v 反推的日成交额:
| 标的与交易日 | 四价(开 / 高 / 低 / 收) | 成交量(万股) / 撮合笔数 | 真实 vw vs 四价均值(差值) | 反推成交额(亿美元) |
|---|---|---|---|---|
| NVDA 2026-11-13 | 169.905 / 170.00 / 158.39 / 162.85 | 36,579.66 / 4,997,505 笔 | 162.4145 vs 165.2862(-2.8717) | 594.11 |
| NVDA 2026-11-12 | 151.005 / 167.14 / 148.80 / 166.19 | 74,770.76 / 9,573,490 笔 | 161.6420 vs 158.2837(+3.3583) | 1,208.61 |
| TSLA 2026-11-13 | 401.675 / 404.40 / 385.8302 / 390.22 | 3,239.30 / 856,569 笔 | 391.6950 vs 395.5313(-3.8363) | 126.88 |
| SPY 2026-11-13 | 760.07 / 760.12 / 747.88 / 754.37 | 3,872.00 / 573,433 笔 | 753.1837 vs 755.6100(-2.4263) | 291.63 |
| AAPL 2026-11-13 | 357.96 / 360.83 / 355.75 / 356.27 | 4,002.75 / 696,735 笔 | 357.5292 vs 357.7025(-0.1733) | 143.11 |
| AAPL 2026-11-11 | 349.545 / 355.91 / 349.325 / 355.63 | 3,445.35 / 684,164 笔 | 354.3937 vs 352.6025(+1.7912) | 122.10 |
2026-11-12 当日,NVDA 低开高走,全天撮合 957.35 万笔、按 vw × v 反推成交额达 1,208.61 亿美元,真实 vw 比四价均值高出 3.3583 美元;次日冲高回落,真实 vw 又比四价均值低 2.8717 美元。若拿四价简单均值替代真实 vw 评估机构算法执行滑点,单日就会产生约 2% 的偏差。
2. 纳秒级逐笔成交(Trades)、SIP 条件码过滤与实时 NBBO 买卖盘口(Quotes)
对 AAPL 拉取 2026-11-13 全天(04:00 至 20:00 ET)共 828 根 1 分钟 K 线核验可见:盘前 04:00:00 首根分钟线最低触及 355.4463 美元(成交 2,750.28 股、606 笔);而 09:30:00 美东正盘首根分钟线开盘价为 357.96 美元(单分钟成交 994,644.20 股、14,024 笔,真实 vw 为 358.6020 美元),与日线正盘开盘价 357.96 美元完全一致。
盘前 355.4463 美元低价之所以未改写日线最低价(355.75 美元),源于美国 SIP 合并行情规则:在 Trades(逐笔成交接口,GET /v3/trades/{stockTicker})中,每笔记录均带 19 位纳秒级撮合时间戳 participant_timestamp、SIP 广播时间戳 sip_timestamp 与条件码数组 conditions(字典见 Condition Codes(成交条件代码接口))。按 SIP 规范,碎股成交(Odd Lot,不足整手股数,条件码如 37)与盘前盘后延长交易(Form T,条件码如 12)计入总成交量 v,但不更新官方正盘日线最高价、最低价与收盘价。
此外,Quotes(报价接口,GET /v3/quotes/{stockTicker})与 Single Ticker Snapshot(单标的快照接口)提供了全美最优买卖一档挂单。下表为 2026-11-16 美东盘中(10:12:29 至 10:12:30 ET)实测拉取的四只标的实时 NBBO 盘口数据:
| 标的代码 | 美东快照时间 | 最新成交价 | 买一价(bid) / 挂单量 | 卖一价(ask) / 挂单量 | 买卖价差(美元 / 基点) |
|---|---|---|---|---|---|
| SPY | 2026-11-16 10:12:30 | 744.92 | 744.92 / 160 股 | 744.93 / 80 股 | 0.01 美元 / 0.13 bps |
| NVDA | 2026-11-16 10:12:30 | 159.74 | 159.71 / 100 股 | 159.74 / 100 股 | 0.03 美元 / 1.88 bps |
| AAPL | 2026-11-16 10:12:29 | 353.925 | 353.89 / 240 股 | 353.96 / 80 股 | 0.07 美元 / 1.98 bps |
| TSLA | 2026-11-16 10:12:29 | 376.775 | 376.72 / 120 股 | 376.83 / 40 股 | 0.11 美元 / 2.92 bps |
AAPL 与 TSLA 当时的最新成交价均处于买卖一档中间价(Mid-price)附近,SPY 盘口价差窄至 0.13 bps,而高波动的 TSLA 价差为 2.92 bps。高频策略测算盘口冲击成本与订单流不平衡时,必须依赖独立 NBBO 报价流。
3. OPRA 全美期权链(Options Chain)、隐含波动率(IV)与 Greeks 一步到位
美股期权 K 线与逐笔历史可追溯至 2014 年 6 月 2 日(报价始于 2022 年 3 月 7 日),实操需把握两条规则:
- 21 位 OCC 合约代码与
expired=true历史检索:期权代码由O:前缀 + 根代码 + 6 位到期日YYMMDD+ 方向C/P+ 8 位行权价整数(行权价乘 1000 左补零)组成(如 2025-12-19 到期、行权价 600 美元的 SPY 看涨期权为O:SPY251219C00600000)。调 All Contracts(全部合约接口)回测已摘牌历史期权时,必传expired=true。 - 期权链快照直接返回 Greeks 与 IV:调用期权链快照接口(
GET /v3/snapshot/options/{underlyingAsset},单页默认 10 张、最高可设limit=250并配合next_url翻页拉取全链),合约节点提供当日 OHLCV、持仓量(open_interest)、隐含波动率(implied_volatility)、保本价(break_even_price)与希腊字母字典greeks(delta、gamma、theta、vega),并按套餐权限返回最新逐笔(last_trade)与 OPRA 最优盘口(last_quote)。
4. CME 四大所期货(Futures)与 S3 Flat Files 全市场离线归档
Massive 期货线覆盖芝商所集团(CME、CBOT、NYMEX、COMEX,历史始于 2017 年 4 月 3 日)。可通过 Products(产品目录接口)与期货合约列表接口按品种(如 product_code=ES、纳指 NQ、原油 CL、黄金 GC)查询到期月合约、最小变动价位(trade_tick_size)与结算日,并配合 Schedules(交易时间表接口)处理主力展期。
若需将十余年全市场分钟线(Minute Aggregates(分钟聚合接口))或逐笔数据(Trades(逐笔成交文件接口))建入本地库,可直接通过 S3 兼容端点 https://files.massive.com(存储桶 flatfiles)按日拉取 .csv.gz 压缩包(文件内 window_start 为 19 位 UTC 纳秒整数)。
如何用 Python 对接 Massive 接口?游标分页、毫秒/纳秒时区对齐与实盘对账代码
编写 Massive 采集代码时需注意三项规范:
- 13 个
/vX/固定路径字面量切勿替换:如 Ticker Events(代码变更事件接口,GET /vX/reference/tickers/{id}/events)、10-K Sections(10-K 年报章节接口,GET /stocks/filings/10-K/vX/sections)等 13 个路径中的/vX/是固定字面量,严禁改写为/v1/或/v3/(全表见 数据口径与编码规范手册)。 next_url游标分页:单次查询达limit上限时,直接携带Authorization: Bearer <API_KEY>请求头访问响应顶层返回的next_url即可拉取下一页,勿重复拼接原参数。- 时间戳精度与夏令时(DST):REST 聚合 K 线的
t为 13 位毫秒,逐笔/盘口sip_timestamp为 19 位纳秒;切分美股正盘(09:30–16:00)须转为America/New_York时区。
以下 Python 脚本读取环境变量 MASSIVE_API_KEY,拉取 NVDA、TSLA、SPY、AAPL 在 2026-11-11 至 2026-11-13 的日线聚合数据,从毫秒时间戳 t 解析美东交易日,并核算真实 vw 与四价均值的差值及日成交额:
import os
from datetime import datetime
from zoneinfo import ZoneInfo
import requests
API_KEY = os.environ["MASSIVE_API_KEY"]
BASE_URL = os.environ.get("MASSIVE_BASE_URL", "https://api.massive.com")
ET_TZ = ZoneInfo("America/New_York")
def audit_massive_daily_vwap(tickers: tuple = ("NVDA", "TSLA", "SPY", "AAPL"), start: str = "2026-11-11", end: str = "2026-11-13") -> list:
session = requests.Session()
session.headers.update({"Authorization": f"Bearer {API_KEY}"})
out = []
for sym in tickers:
url = f"{BASE_URL}/v2/aggs/ticker/{sym}/range/1/day/{start}/{end}"
bars = session.get(url, params={"adjusted": "true", "sort": "desc", "limit": 10}, timeout=15).json().get("results", [])
for b in bars:
trade_date = datetime.fromtimestamp(b["t"] / 1000, ET_TZ).date().isoformat()
ohlc4 = round((b["o"] + b["h"] + b["l"] + b["c"]) / 4.0, 4)
out.append({
"symbol": sym,
"date": trade_date,
"close": b["c"],
"vol_m": round(b["v"] / 1e4, 2),
"trades": b["n"],
"true_vw": b["vw"],
"ohlc4": ohlc4,
"vw_diff": round(b["vw"] - ohlc4, 4),
"turnover_b": round((b["vw"] * b["v"]) / 1e8, 2),
})
return out
if __name__ == "__main__":
for row in audit_massive_daily_vwap():
if row["date"] == "2026-11-13" or (row["symbol"] in ("NVDA", "AAPL") and row["date"] in ("2026-11-12", "2026-11-11")):
print(f"{row['symbol']:4s} | {row['date']} | 收盘:{row['close']:7.2f} | 量:{row['vol_m']:8.2f}万股 | 笔数:{row['trades']:7d} | 真vw:{row['true_vw']:8.4f} | 四价均值:{row['ohlc4']:8.4f} | 差值:{row['vw_diff']:+7.4f} | 成交额:{row['turnover_b']:7.2f}亿美元")
根据上述函数返回结果整理输出如下:
NVDA | 2026-11-13 | 收盘: 162.85 | 量:36579.66万股 | 笔数:4997505 | 真vw:162.4145 | 四价均值:165.2862 | 差值:-2.8717 | 成交额: 594.11亿美元
NVDA | 2026-11-12 | 收盘: 166.19 | 量:74770.76万股 | 笔数:9573490 | 真vw:161.6420 | 四价均值:158.2837 | 差值:+3.3583 | 成交额:1208.61亿美元
NVDA | 2026-11-11 | 收盘: 173.73 | 量:33921.48万股 | 笔数:4831717 | 真vw:171.9234 | 四价均值:173.7100 | 差值:-1.7866 | 成交额: 583.19亿美元
TSLA | 2026-11-13 | 收盘: 390.22 | 量: 3239.30万股 | 笔数: 856569 | 真vw:391.6950 | 四价均值:395.5313 | 差值:-3.8363 | 成交额: 126.88亿美元
SPY | 2026-11-13 | 收盘: 754.37 | 量: 3872.00万股 | 笔数: 573433 | 真vw:753.1837 | 四价均值:755.6100 | 差值:-2.4263 | 成交额: 291.63亿美元
AAPL | 2026-11-13 | 收盘: 356.27 | 量: 4002.75万股 | 笔数: 696735 | 真vw:357.5292 | 四价均值:357.7025 | 差值:-0.1733 | 成交额: 143.11亿美元
AAPL | 2026-11-12 | 收盘: 354.88 | 量: 3187.50万股 | 笔数: 658785 | 真vw:356.3117 | 四价均值:356.6171 | 差值:-0.3054 | 成交额: 113.57亿美元
AAPL | 2026-11-11 | 收盘: 355.63 | 量: 3445.35万股 | 笔数: 684164 | 真vw:354.3937 | 四价均值:352.6025 | 差值:+1.7912 | 成交额: 122.10亿美元
哪些需求 Massive 覆盖不到?官方套餐价格体系与非专业(Non-Professional)合规红线
1. 数据覆盖与口径边界:何时应搭配基本面专用源?
工程选型时需清楚 Massive 的四条能力边界:
- 股票仅限美股本土市场(无港股与 A 股):仅覆盖 NYSE、Nasdaq、Cboe 等美股市场(SIP 合并流),不含港交所(
.HK)或沪深 A 股(.SS/.SZ)行情。 - K 线
adjusted=true仅做拆合股复权,不含现金分红:复权参数只按 Splits(拆合股接口)修正拆并股,不扣除现金股息;计算全收益(Total Return)须调 Dividends(现金分红接口)自行连乘复权。 - 财务比率接口的 EPS/PE 采用时点流通股本分母:Ratios(财务比率接口,自 2009 年起)中的
earnings_per_share与price_to_earnings采用股价日时点流通股数计算,与 Income Statements(利润表接口)按报告期加权平均股本计算的basic_earnings_per_share及diluted_earnings_per_share存在差异。 - 无营收分部拆解、无财报电话会文字稿与 DCF 估值:若投研依赖按产品/地区拆解营收、电话会文字稿(Transcripts)、现成分红复权日线或全球多市场财报,建议搭配 FMP数据源中文站 互补使用。
2. 官方个人套餐价格表与五条资产线独立计费规则
Massive 将 美股(Stocks)、期权(Options)、期货(Futures)、指数(Indices)、外汇与加密(Currencies)五条资产线拆开独立售卖。以下为官方个人股票套餐(月付口径)权限阶梯(以官方最新公示为准):
| 股票套餐档位 | 月付标价 | 时效与历史深度 | REST、WebSocket 与 Flat Files 真实权限边界 |
|---|---|---|---|
| Stocks Basic | 0 美元/月 | 日终(EOD),2 年历史 | 限速 5 次/分钟;无盘中实时数据,次日可查历史日线/分钟线聚合与基础参考接口,无 WS 实时流、无 Flat Files |
| Stocks Starter | 29 美元/月 | 15 分钟延迟,5 年历史 | 不限 REST 调用次数;含日线/分钟线聚合、延迟 WS 流及聚合类 Flat Files;不含逐笔成交(Trades)与报价(Quotes) |
| Stocks Developer | 79 美元/月 | 15 分钟延迟,10 年历史 | 解锁历史逐笔成交(Trades REST API 及 Trades Flat Files);仍不含 NBBO 报价明细(Quotes) |
| Stocks Advanced | 199 美元/月 | 实时数据,20+ 年全历史 | 解锁全部实时与历史 Trades、NBBO 报价明细(Quotes REST、WS 及 Flat Files),并含 Financials & Ratios 财务包 |
成本核算需留意两点:第一,期权与期货的 Starter / Developer / Advanced 同样按 29 / 79 / 199 美元/月独立计费,若同时订阅美股、期权、期货三线实时 Advanced 套餐,月费达 597 美元/月(指数实时另需 99 美元/月,外汇加密需 49 美元/月)。第二,严查 Non-Professional(非专业个人)资质——个人档须通过 11 题问卷且仅限本人非商业研究;只要数据展示在他人可见的屏幕上(含内部同事或测试环境),均须购买 Business 商业套餐(如期货商业授权为每交易所 999 美元/月)。
常见问题(FAQ)
Q1:为什么调用聚合 K 线或快照接口返回 HTTP 200 OK,但 results 数组为空?
排除休市日后,多源于漏写标的前缀(或调全部期权合约接口查已到期合约时漏传 expired=true):美股无前缀,但指数加 I:(I:SPX)、外汇加 C:(C:EURUSD)、加密加 X:(X:BTCUSD)、期权合约加 O:(O:SPY251219C00600000),多类别股用点号(BRK.A)。详见 数据口径与编码规范手册。
Q2:Flat Files(S3 历史文件)可以直接用 REST API Key 下载吗?
不可以。Flat Files 托管在 https://files.massive.com(存储桶 flatfiles),须用独立的 S3 Access Key ID 与 Secret Access Key 配合 boto3 或 aws s3 CLI 下载,传 REST API Key 会返回 403 Forbidden。分块读取代码见 Flat Files 快速接入指南。
Q3:如何让 Cursor、Claude Code 等 AI 编程工具准确生成 Massive 接口代码而不报 404?
在 Cursor(@Docs 添加本站 /llms.txt)或 Claude Code 中,先引导 AI 读取根目录 /llms.txt 与 开发文档总览,即可对齐 211 篇接口路径与 4,835 个字段定义;更多排障见 常见技术与数据口径问答。