美股 REST 接口概览
通过REST 接口使用美股数据。REST 通道用于按需查询历史行情、快照与参考数据，路径与参数与官方文档一致，便于把已有代码直接改指向本站。适合回测取数、批量补数与后台任务。
聚合 K 线
自定义 K 线（OHLC）Custom Bars (OHLC)
股票自定义 K 线聚合。按自定义日期范围与时间粒度（美东时区）获取指定股票的聚合开盘价、最高价、最低价、收盘价与成交量数据。聚合仅基于满足条件的有效成交生成；某时间窗内若无有效成交，则不产生 K 线。可通过 multiplier 与 timespan 参数调整粒度，例如 5 分钟 K 线；支持盘前、常规与盘后时段。
GET /v2/aggs/ticker/{stocksTicker}/range/{multiplier}/{timespan}/{from}/{to}查看参数、字段和示例 →每日市场汇总（OHLC）Daily Market Summary (OHLC)
美股全市场日线汇总。获取指定交易日全部美股的日频开盘价、最高价、最低价、收盘价、成交量与成交量加权平均价（VWAP）。一次请求即可完成全市场覆盖。
GET /v2/aggs/grouped/locale/us/market/stocks/{date}查看参数、字段和示例 →每日标的汇总（OHLC）Daily Ticker Summary (OHLC)
股票当日开收盘价。获取指定股票在给定日期的开盘与收盘价，以及盘前与盘后成交价，用于评估当日表现并了解常规时段之外的交易活动。
GET /v1/open-close/{stocksTicker}/{date}查看参数、字段和示例 →前一日 K 线（OHLC）Previous Day Bar (OHLC)
股票前一日 K 线。获取指定股票在前一交易日的开盘价、最高价、最低价、收盘价与成交量数据，用于评估近期表现并辅助交易决策。
GET /v2/aggs/ticker/{stocksTicker}/prev查看参数、字段和示例 →公司行动
现金分红Dividends
分红（含复权因子）。获取指定标的的现金分红历史记录，包括宣告日、除息日、股权登记日与派息日，以及派息金额与用于还原历史价格的复权因子，便于在收益计算中计入分红收入并支持税务申报。
GET /stocks/v1/dividends查看参数、字段和示例 →首次公开募股（IPO）Initial Public Offerings (IPOs)
首次公开募股（IPO）。获取 IPO 的完整信息，包括自 2008 年起的未来与历史事件，涵盖发行人名称、股票代码、证券类型、上市日期、发行股数、预期价格区间、最终发行价与发行规模。可按状态（待定、新股、传闻、历史）过滤。
GET /vX/reference/ipos查看参数、字段和示例 →现金分红（已弃用）Dividends (Deprecated)
分红。获取指定标的的现金分红历史记录，包括宣告日、除息日、股权登记日与派息日，以及派息金额与分红频率。
GET /v3/reference/dividends查看参数、字段和示例 →拆合股（已弃用）Splits (Deprecated)
拆合股。获取历史拆合股事件，包括执行日期与比例因子，用于理解公司股本结构的变化。相关复权因子也被用于其他接口（如 K 线聚合）的价格还原，从而可同时获取复权与未复权价格。
GET /v3/reference/splits查看参数、字段和示例 →拆合股Splits
拆合股（含复权因子）。获取历史拆合股事件，包括执行日期与比例因子，并可获得用于将历史价格还原到当前股本口径的复权因子。
GET /stocks/v1/splits查看参数、字段和示例 →代码变更事件Ticker Events
代码变更事件。获取与指定股票代码、CUSIP 或综合 FIGI 关联的关键事件时间线。该接口为实验性功能，重点呈现代码变更（如更名、品牌变更），帮助在记录与分析中保持连续性。
GET /vX/reference/tickers/{id}/events查看参数、字段和示例 →SEC 申报文件
10-K 年报章节10-K Sections
10-K 年报章节。获取年度 10-K 申报文件中关键叙述章节的纯文本提取，包括业务概述与风险因素，以结构化的、便于 AI 处理的格式提供公司运营、战略、市场与重大风险的详细信息。
GET /stocks/filings/10-K/vX/sections查看参数、字段和示例 →13-F 持仓披露13-F Filings
13-F 持仓披露。获取管理资产规模不低于 1 亿美元的机构投资管理人提交的 SEC Form 13-F 季度持仓数据，包含季末的股票持仓、股数、市值、投资决策权与投票权。
GET /stocks/filings/vX/13-F查看参数、字段和示例 →8-K 重大事项披露8-K Disclosures
8-K 重大事项披露。对 SEC 8-K 申报文件中的披露内容做分类：申报文件中的每一项重大事件（管理层变动、并购、重大协议、监管行动等）都被归入统一的三级分类体系（一级、二级、三级），并附申报文件原文摘录。一份申报文件包含多项披露时会产生多条记录。完整分类体系可通过「披露类别」接口获取。
GET /stocks/filings/8-K/vX/disclosures查看参数、字段和示例 →8-K 核心条目文本8-K Text
8-K 核心条目文本。获取 Form 8-K 当前报告中核心 Items 章节解析后的纯文本内容，披露并购、管理层变动、重大合同等重大事项，以便于 AI 处理的格式提供。
GET /stocks/filings/8-K/vX/text查看参数、字段和示例 →披露类别Disclosure Categories
披露类别。获取用于归类 SEC 8-K 披露内容的完整标准化层级分类体系，包含一级、二级、三级类别及详细说明，是 8-K 披露接口背后的受控词表。
GET /stocks/taxonomies/vX/disclosures查看参数、字段和示例 →Form 3 初始持股申报Form 3
Form 3 初始持股申报。获取 SEC Form 3 申报文件，报告公司内部人（董事、高管及持股 10% 以上股东）首次持有的证券权益。当内部人首次适用第 16 条报告义务时，这些申报文件确立了其持股基数。
GET /stocks/filings/vX/form-3查看参数、字段和示例 →Form 4 持股变动申报Form 4
Form 4 持股变动申报。获取 SEC Form 4 申报文件，披露公司内部人持股权益的所有变动。任何交易（买入、卖出、行权、授予、赠与等）须在两个工作日内申报，包含日期、价格、股数与交易代码等详细数据。
GET /stocks/filings/vX/form-4查看参数、字段和示例 →SEC EDGAR 索引SEC EDGAR Index
SEC EDGAR 索引。获取全部 SEC EDGAR 申报文件的主索引，包括表单类型、申报日期、CIK、股票代码、发行人名称、档案号以及指向 SEC.gov 原始申报文件的直达链接。这是整个 EDGAR 数据库的中央检索层，无需在网站上手工翻查，即可完成强过滤与排序。
GET /stocks/filings/vX/index查看参数、字段和示例 →风险类别Risk Categories
风险类别。获取用于归类 SEC 申报文件风险因素的完整标准化层级分类体系，包含一级、二级、三级类别及详细说明与示例，便于跨公司与跨期做一致分析。
GET /stocks/taxonomies/vX/risk-factors查看参数、字段和示例 →风险因素Risk Factors
风险因素。来自 SEC 申报文件的标准化、机器可读的风险因素披露。每个风险因素按统一分类体系归类，便于跨期或跨公司直接比较。
GET /stocks/filings/vX/risk-factors查看参数、字段和示例 →财务数据
资产负债表Balance Sheets
资产负债表。获取上市公司的资产负债表数据，包含季度与年度财务状况，涵盖资产、负债与所有者权益。资产负债表是特定时点的财务状况快照（存量而非流量），反映各期末公司拥有什么、欠什么，以及股东权益是多少。
GET /stocks/financials/v1/balance-sheets查看参数、字段和示例 →现金流量表Cash Flow Statements
现金流量表。获取上市公司的现金流量表数据，包含季度、年度与滚动十二个月（TTM）现金流，涵盖经营、投资与融资活动的现金流量明细，TTM 由四个季度各分量加总得到。
GET /stocks/financials/v1/cash-flow-statements查看参数、字段和示例 →流通股本Float
流通股本（自由流通）。获取指定股票的最新自由流通股本。自由流通股本指扣除战略或长期持有者持股后、可公开交易的股份数量。创始人、高管与董事、员工、控股股东、关联公司、私募股权与风险投资、主权财富基金、政府机构、员工持股计划、信托、限售或锁定股份，以及持股 5% 以上的股东所持股份不计入可流通供给；养老金、共同基金、ETF、无董事会席位的对冲基金、存托银行等广泛分散的投资者持股一般计入。自由流通股本是衡量流动性、波动率、市场冲击与股权结构的关键输入；数据基于公开披露与持股信息，可能存在报告时滞。
GET /stocks/vX/float查看参数、字段和示例 →利润表Income Statements
利润表。获取上市公司的利润表数据，包括营收、费用与净利润等关键指标，涵盖季度、年度与滚动十二个月（TTM）口径的详细财务表现，含营收拆分、营业费用与盈利能力指标。
GET /stocks/financials/v1/income-statements查看参数、字段和示例 →财务比率Ratios
财务比率。提供估值、盈利能力、流动性与杠杆等关键财务比率，将利润表、资产负债表与现金流量表的数据与每日股价结合，按最近一个交易日、以滚动十二个月（TTM）财务数据计算。
GET /stocks/financials/v1/ratios查看参数、字段和示例 →空头持仓Short Interest
空头持仓。获取经纪交易商向 FINRA 报送的聚合空头持仓数据，频率为两周一次。空头持仓指已卖空但尚未回补或平仓的股份总数，可反映市场情绪与潜在价格变动；高企的空头持仓可能意味着看空情绪，也可能提示轧空机会。
GET /stocks/v1/short-interest查看参数、字段和示例 →卖空成交量Short Volume
卖空成交量。获取经纪商向 FINRA 报送的、来自场外交易场所与另类交易系统（ATS）的每日聚合卖空成交量。与衡量特定期末未平仓空头的「空头持仓」不同，卖空成交量反映的是卖空交易的每日活动，可用于捕捉短期情绪变化、分析交易行为并识别卖空趋势。
GET /stocks/v1/short-volume查看参数、字段和示例 →市场运行
成交条件代码Condition Codes
聚合来自各上游行情源（CTA、UTP、OPRA、FINRA 等）的成交与报价条件代码。每个条件标识行情数据中的特殊情形（例如非正常时段成交、均价成交），并说明这些条件如何影响最高价、最低价、开盘价、收盘价与成交量等指标。理解这些映射有助于正确解读行情上下文、施加合适的过滤条件，确保聚合数据准确反映可计入的交易活动。
GET /v3/reference/conditions查看参数、字段和示例 →交易所名录Exchanges
获取已知交易所清单，包括其标识、名称、市场类型及其他相关属性，可用于映射交易所代码、了解市场覆盖范围并将交易所信息集成到自己的应用中。
GET /v3/reference/exchanges查看参数、字段和示例 →市场休市安排Market Holidays
获取即将到来的市场休市安排及其对应的开市、收市时间。该接口仅提供前瞻性数据，列出会影响市场交易时段的未来休市日，可用于提前规划交易活动与系统运维窗口。
GET /v1/marketstatus/upcoming查看参数、字段和示例 →市场状态Market Status
获取各交易所及整体金融市场当前的交易状态，实时指示市场处于开市、休市还是盘前、盘后时段，并附带当前或下一交易时段的起止时间。
GET /v1/marketstatus/now查看参数、字段和示例 →接口
行情快照
全市场快照Full Market Snapshot
美股全市场快照。一次响应返回整个美股市场的快照，覆盖 10000 多个活跃标的，汇总价格、成交量与成交活动等信息，无需多次查询。快照数据每日美东时间 3:30 清空，随后随交易所上报新数据逐步回填，最早可能从 4:00 开始。
GET /v2/snapshot/locale/us/markets/stocks/tickers查看参数、字段和示例 →单标的快照Single Ticker Snapshot
单标的美股快照。汇总指定标的最新成交、报价以及分钟、日线、前一日等聚合数据。快照数据于美东时间 3:30 清空，并随交易所上报新数据逐步更新，最早可能从 4:00 开始。便于紧盯单个标的的实时动态。
GET /v2/snapshot/locale/us/markets/stocks/tickers/{stocksTicker}查看参数、字段和示例 →市场涨跌榜Top Market Movers
美股涨跌幅榜。给出美股涨幅或跌幅最大的 20 个标的：涨幅榜按相对前收盘涨幅最大排序，跌幅榜反之。为保证参考意义，仅纳入成交量不低于 10000 的标的。快照数据每日美东时间 3:30 清空并随交易所上报逐步回填。
GET /v2/snapshot/locale/us/markets/stocks/{direction}查看参数、字段和示例 →统一快照Unified Snapshot
一次请求即可获取股票、期权、外汇、加密货币等多资产类别的统一行情快照，涵盖最新成交、最新报价以及开盘价、最高价、最低价、收盘价与成交量等关键指标，可一览当前市场全貌。该接口把各来源数据聚合到一次响应中，便于高效监控、比较并据此操作跨市场、跨资产类别的信息。
GET /v3/snapshot查看参数、字段和示例 →技术指标
指数移动平均（EMA）Exponential Moving Average (EMA)
获取指定标的在给定时间范围内的指数移动平均（EMA）。EMA 对近期价格赋予更高权重，因此能更快识别趋势并给出更灵敏的信号。
GET /v1/indicators/ema/{stockTicker}查看参数、字段和示例 →平滑异同移动平均（MACD）Moving Average Convergence/Divergence (MACD)
获取指定标的在给定时间范围内的平滑异同移动平均（MACD）。MACD 是由两条移动平均线推导而来的动量指标，可用于判断趋势强度、方向以及潜在买卖信号。
GET /v1/indicators/macd/{stockTicker}查看参数、字段和示例 →相对强弱指标（RSI）Relative Strength Index (RSI)
获取指定标的在给定时间范围内的相对强弱指标（RSI）。RSI 衡量价格变化的速度与幅度，在 0 到 100 之间波动，用于识别超买或超卖状态。
GET /v1/indicators/rsi/{stockTicker}查看参数、字段和示例 →简单移动平均（SMA）Simple Moving Average (SMA)
获取指定标的在给定时间范围内的简单移动平均（SMA）。SMA 按设定的周期数计算平均价格，平滑价格波动以揭示潜在趋势与信号。
GET /v1/indicators/sma/{stockTicker}查看参数、字段和示例 →标的资料
全部标的代码All Tickers
获取 Massive 上游支持的全部标的代码清单，覆盖股票、指数、外汇、加密货币等多个资产类别。每个条目给出代码、名称、市场、币种与是否仍在交易等关键信息。
GET /v3/reference/tickers查看参数、字段和示例 →关联标的Related Tickers
关联标的。获取与指定标的相关的其他标的清单，通过新闻报道与收益率数据分析识别，可用于发现同行业公司、竞争对手或主题相似的公司，辅助对比分析、组合分散与市场研究。
GET /v1/related-companies/{ticker}查看参数、字段和示例 →标的概览Ticker Overview
单标的美股详情。获取指定标的（截至某日期仍处于交易状态）的完整资料，包括主交易所、标准化标识（CIK、综合 FIGI、股份类别 FIGI）、市值、行业分类与关键日期，并提供 Logo、图标等品牌素材。若需查询已退市标的，请在「全部标的」接口中使用 active=false。
GET /v3/reference/tickers/{ticker}查看参数、字段和示例 →标的类型Ticker Types
标的类型。获取 Massive 上游支持的全部标的类型。该接口按资产类别、市场与工具对标的分类，帮助理解不同分类及其属性。
GET /v3/reference/tickers/types查看参数、字段和示例 →成交与报价
最新报价Last Quote
股票最新报价（NBBO）。获取指定股票的最新全国最优买卖报价（NBBO），包括最新买卖价、数量、交易所详情与时间戳，便于评估流动性、跟踪价差并做出更明智的判断。
GET /v2/last/nbbo/{stocksTicker}查看参数、字段和示例 →最新成交Last Trade
股票最新成交。获取指定股票的最新一笔成交，包括价格、数量、交易所与时间戳，便于监控近期交易活动并刷新看板。
GET /v2/last/trade/{stocksTicker}查看参数、字段和示例 →报价Quotes
股票历史报价（NBBO）。获取指定股票在给定时间范围内的 NBBO 报价，每条记录包含各时刻的最优买卖价、数量、交易所与时间戳，反映一档报价环境。可用于分析价格变化并评估 NBBO 层面的流动性。
GET /v3/quotes/{stockTicker}查看参数、字段和示例 →逐笔成交Trades
股票逐笔成交。获取指定股票在给定时间范围内的逐笔成交数据，每条记录包含价格、数量、交易所、成交条件与精确时间戳。逐笔数据是构建聚合 K 线与深入分析的基础，可据此研究盘中价格变化、验证并优化算法策略，并保留可审计的市场活动记录。
GET /v3/trades/{stockTicker}查看参数、字段和示例 →使用前注意
- 核对标的代码、时间范围、复权方式与分页。
- 保留接口路径中的版本号；不要统一加上额外的 /v1 前缀。