期权 REST 接口概览
通过REST 接口使用期权数据。REST 通道用于按需查询历史行情、快照与参考数据，路径与参数与官方文档一致，便于把已有代码直接改指向本站。适合回测取数、批量补数与后台任务。
聚合 K 线
自定义 K 线（OHLC）Custom Bars (OHLC)
期权自定义 K 线聚合。按自定义日期范围与时间粒度（美东时区）获取指定期权合约的聚合开盘价、最高价、最低价、收盘价与成交量数据。聚合仅基于满足条件的有效成交生成；某时间窗内若无有效成交，则不产生 K 线。可通过 multiplier 与 timespan 参数调整粒度，例如 5 分钟 K 线。
GET /v2/aggs/ticker/{optionsTicker}/range/{multiplier}/{timespan}/{from}/{to}查看参数、字段和示例 →每日标的汇总（OHLC）Daily Ticker Summary (OHLC)
期权当日开收盘价。获取指定期权合约在给定日期的开盘与收盘价，以及盘前与盘后成交价，用于评估当日表现并了解常规时段之外的交易活动。
GET /v1/open-close/{optionsTicker}/{date}查看参数、字段和示例 →前一日 K 线（OHLC）Previous Day Bar (OHLC)
期权前一日 K 线。获取指定期权合约在前一交易日的开盘价、最高价、最低价、收盘价与成交量数据，用于评估近期表现并辅助交易决策。
GET /v2/aggs/ticker/{optionsTicker}/prev查看参数、字段和示例 →合约资料
全部合约All Contracts
期权合约索引。获取期权合约的完整索引，涵盖正在交易与已到期合约，可返回全量或按特定标的筛选。每个合约条目包含合约类型（看涨或看跌）、行权方式、到期日与行权价等信息，可用于评估市场供给并筛选符合条件的合约。
GET /v3/reference/options/contracts查看参数、字段和示例 →合约概览Contract Overview
期权合约详情。获取指定期权合约的详细信息，包括合约类型（看涨或看跌）、行权方式、到期日、行权价、每张合约股数、底层标的代码与主交易所，是理解合约结构并纳入期权策略与组合评估的基础。
GET /v3/reference/options/contracts/{options_ticker}查看参数、字段和示例 →市场运行
成交条件代码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查看参数、字段和示例 →行情快照
期权链快照Option Chain Snapshot
期权链快照。获取指定标的关联的全部期权合约快照，汇总每个合约的价格、希腊字母（delta、gamma、theta、vega）、隐含波动率、报价、成交与未平仓量，并给出标的当前价格与盈亏平衡点。一次请求即可获得完整期权链，便于比较各合约特征并优化策略。
GET /v3/snapshot/options/{underlyingAsset}查看参数、字段和示例 →期权合约快照Option Contract Snapshot
期权合约快照。将指定期权合约的关键指标与行情数据汇总在单个响应中，包括盈亏平衡价、日间变动、隐含波动率、未平仓量、希腊字母（delta、gamma、theta、vega）以及最新报价与成交，并给出标的当前价格。
GET /v3/snapshot/options/{underlyingAsset}/{optionContract}查看参数、字段和示例 →统一快照Unified Snapshot
一次请求即可获取股票、期权、外汇、加密货币等多资产类别的统一行情快照，涵盖最新成交、最新报价以及开盘价、最高价、最低价、收盘价与成交量等关键指标，可一览当前市场全貌。该接口把各来源数据聚合到一次响应中，便于高效监控、比较并据此操作跨市场、跨资产类别的信息。
GET /v3/snapshot查看参数、字段和示例 →技术指标
指数移动平均（EMA）Exponential Moving Average (EMA)
获取指定标的在给定时间范围内的指数移动平均（EMA）。EMA 对近期价格赋予更高权重，因此能更快识别趋势并给出更灵敏的信号。
GET /v1/indicators/ema/{optionsTicker}查看参数、字段和示例 →平滑异同移动平均（MACD）Moving Average Convergence/Divergence (MACD)
获取指定标的在给定时间范围内的平滑异同移动平均（MACD）。MACD 是由两条移动平均线推导而来的动量指标，可用于判断趋势强度、方向以及潜在买卖信号。
GET /v1/indicators/macd/{optionsTicker}查看参数、字段和示例 →相对强弱指标（RSI）Relative Strength Index (RSI)
获取指定标的在给定时间范围内的相对强弱指标（RSI）。RSI 衡量价格变化的速度与幅度，在 0 到 100 之间波动，用于识别超买或超卖状态。
GET /v1/indicators/rsi/{optionsTicker}查看参数、字段和示例 →简单移动平均（SMA）Simple Moving Average (SMA)
获取指定标的在给定时间范围内的简单移动平均（SMA）。SMA 按设定的周期数计算平均价格，平滑价格波动以揭示潜在趋势与信号。
GET /v1/indicators/sma/{optionsTicker}查看参数、字段和示例 →成交与报价
最新成交Last Trade
期权最新成交。获取指定期权合约的最新一笔成交，包括价格、数量、交易所与时间戳，便于监控近期交易活动并刷新看板。
GET /v2/last/trade/{optionsTicker}查看参数、字段和示例 →报价Quotes
期权历史报价。获取指定期权合约在给定时间范围内的历史报价，每条记录包含买卖价、数量、交易所标识与精确时间戳，反映各时刻的期权市场状况。可用于分析价格变化、评估特定期权行权价与到期日的市场关注度。
GET /v3/quotes/{optionsTicker}查看参数、字段和示例 →逐笔成交Trades
期权逐笔成交。获取指定期权标的在给定时间范围内的逐笔成交数据，每条记录包含价格、数量、交易所、成交条件与精确时间戳。逐笔数据是构建聚合 K 线与深入分析的基础，可据此研究盘中价格变化、验证并优化算法策略，并保留可审计的市场活动记录。
GET /v3/trades/{optionsTicker}查看参数、字段和示例 →使用前注意
- 核对标的代码、时间范围、复权方式与分页。
- 保留接口路径中的版本号；不要统一加上额外的 /v1 前缀。