端点
链与结构（按标的）
单合约（按 OSI 合约代码）
全市场
最新报价
查询指定期权合约最近可用的买价、卖价、中间价与报价时间。
批量最多 50 项（包括重复项）；同一请求内重复合约只返回、计量一次。使用实际合约根代码，例如
SPXW 不可替换成 SPX。需要 scope derived:read。
bid_usd / ask_usd 是每股美元报价；没有有效正数的一侧为 null。只有双边有效且买价不高于卖价时，mid_usd 才返回中间价，否则为 null。两侧均无有效报价时不返回成功报价。它们是报价，不是最新成交价，也不保证可按该价格成交。
quoted_at 是报价本身的 UTC 时间，不是请求时间。休市或不活跃合约的报价时间可能较早；请根据该时间判断报价是否满足你的用途，详见数据新鲜度。
批量成功响应仍为 data + _meta；下面只展示 data 的部分成功形状：
quotes 或 unavailable 中；HTTP 200 不代表所有合约都有报价，quotes 可以为空。缺失项的四种状态与重试方式见批量报价错误处理。
每份成功返回的合约报价计 1 unit，价格未变或报价时间较早也按此计量；缺失项不计。批量调用需要余额覆盖请求的不同合约数量，最终只扣成功返回数量，见配额规则。
示例
注意点
- OI 是滞后指标：未平仓合约数按行业惯例为上一交易日结算后的口径，日内不实时变化；「今天的 OI 变动」要到次日才能完整体现。
chain_snapshot返回完整单到期日集合：total_contracts是完整数量，returned_contracts是当前页数量；当_meta.next_cursor非空时继续翻页。每一页都是一次 weight 1 的调用。每行的quoted_at是该合约报价自己的时间水位，判断报价是否新鲜时优先看它。contract_volume_profile使用相同的分页方式，完整数量和当前页数量分别为total_levels/returned_levels。chain_greeks_history的 OI 是窗口起点后首个上报日的单次快照，不是逐日序列；需要单合约逐日 OI 时使用options.contract_daily。返回可能因响应预算截断，请检查total_contracts/returned_contracts/returned_rows与每个合约的quotes_truncated。chain_greeks_history的contracts[].quotes[].snapshot_at是没有 offset 的 ET 市场墙钟；顶层as_of才是 ISO 8601 UTC 水位。解析行级时间时请显式使用America/New_York，不要按本机时区猜测。- 历史整链查询的最大跨度随
interval改变：1m约 2 天、5m约 6 天、10m约 11 天、15m约 17 天、30m/1h最多 31 天。需要更长窗口时调粗粒度或拆分日期范围。 - RTH 之外的链快照可能仍是上一交易时段的报价与 Greeks；每个交易日 09:30 ET 的首根历史 Greeks 也可能因为尚无有效 NBBO 而出现深度实值合约
implied_vol_pct=0、delta=±1、gamma=0。这些是数据状态，不应直接当作可成交价格或稳定波动率。 - 单合约端点使用 OSI 代码（
标的 + 到期YYMMDD + C/P + 行权价×1000 补零到 8 位），写错格式或到期日不合法返回400 VALIDATION_ERROR。 - 结构分布类端点（OI/volume 分布、max pain）适合做每日结构分析；需要当日盘中动态可以结合 flow 域与 derived 域的实时读面。