数据目录总览

Data API 的数据按领域组织，路径形如 /v1/{领域}/...。本章每个领域一页导读（有什么、怎么用、口径注意点）；字段级定义见顶部「API Reference」标签页或 OpenAPI spec。

领域地图

领域	端点数	内容
derived（自研衍生）	5	0DTE Dealer GEX 与 Dealer Heatmap 公共 Top 节点投影、Standard GEX
flow	11	期权成交流：筛选、榜单、合约链、分钟桶与最多 30 个交易日的合约历史
options	19	期权链结构、OI/成交量分布、max pain、单合约及整链历史 Greeks、单查与批量最新报价
stocks	14	个股与指数：OHLC、最新报价、公司信息、技术指标、lit 成交
volatility	11	波动率：IV rank、期限结构、已实现波动、偏斜与异常
congress	4	美国国会议员交易披露
fundamentals	10	财报三表、盘前盘后财报日历、盈利历史与预期
market	8	市场面：涨跌榜、期权成交量 Top 150、OI 变动与经济/FDA/IPO 日历
macro	6	宏观：经济指标、商品、汇率
insider	6	上市公司内部人（高管/董事）交易披露
institutions	6	机构 13F 持仓与变动
shorts	6	做空：short interest、FTD、做空量与比率
darkpool	3	暗池成交与价格档位

目录会随能力上线持续扩展。运行时的权威目录是 GET /v1/discover——它返回你当前 Key 实际可用的全部能力（capabilities 与逐条的 capabilities_detail），文档如与其不一致，以 discover 为准。

每个端点属于四种覆盖面之一，capabilities_detail 中逐条标注：

coverage	含义	调用体验
`market-wide`	全市场一份数据（如涨跌榜、最新披露流）	无标的参数，直接调用
`on-demand`	按标的准备	按端点支持的标的或合约查询；部分端点首次可能 `202`，期权最新报价返回报价结果或错误（见数据新鲜度）
`direct`	直接读取现有实时或历史读模型	不触发后台准备；读模型暂不可用时返回 `503 READ_MODEL_UNAVAILABLE`
`working-set`	限定标的池（derived 域 = 产品内 Dealer 覆盖票池）	池内标的直接调用；池外返回 `404`

按标的查询：标的在路径中（/v1/shorts/data/{ticker}），大写代码。
按合约查询（options 域）：单查 OSI 合约代码在路径中；批量最新报价使用 contracts 查询参数，传最多 50 项的逗号分隔字符串（见报价端点）。
历史/列表类：from / to / limit / cursor，语义见通用约定。
各端点的完整参数与响应结构：顶部「API Reference」标签页。