期权 成交条件代码 · REST 接口
聚合来自各上游行情源（CTA、UTP、OPRA、FINRA 等）的成交与报价条件代码。每个条件标识行情数据中的特殊情形（例如非正常时段成交、均价成交），并说明这些条件如何影响最高价、最低价、开盘价、收盘价与成交量等指标。理解这些映射有助于正确解读行情上下文、施加合适的过滤条件，确保聚合数据准确反映可计入的交易活动。
GET /v3/reference/conditions上游时效说明
按需更新
上游历史范围
该接口不适用
适用场景
- 数据解读、统一条件映射、过滤与分析、算法调整、合规与报送。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
asset_class | string | No | 按资产类别筛选条件。 |
data_type | string | No | 按数据类型筛选。 |
id | integer | No | 按给定 ID 筛选条件。 |
sip | string | No | 按 SIP 筛选。若该条件包含对应 SIP 的映射，则返回该条件。 |
order | string | No | 按 sort 字段对结果排序。 |
limit | integer | No | 限制返回结果数量，默认 10，最大 1000。 |
sort | string | No | 用于排序的字段。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
count | integer | 本次请求的结果总数。 |
next_url | string | 若存在，可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 与该查询条件匹配的条件数组。 |
results[].abbreviation | string | 该条件的常用缩写。 |
results[].asset_class | enum: stocks, options, crypto, fx | 一组相似金融工具的标识。 |
results[].data_types | array[string] | 该条件适用的数据类型。 |
results[].description | string | 该条件语义的简要说明。 |
results[].exchange | integer | 若存在，则本条件从 Massive 代码映射到 SIP 符号时取决于该属性。也就是说，带有该条件的数据仅来自该交易所。 |
results[].id | integer | Massive 为该条件分配的标识，在每个数据类型内唯一。 |
results[].legacy | boolean | 若为 true，表示该条件来自旧版 SIP 规范、已不再使用。其他条件可能复用同一符号，也可能不复用。 |
results[].name | string | 该条件的名称。 |
results[].sip_mapping | object | 把各 SIP（CTA、OPRA、UTP）的条件代码统一翻译为 Massive 代码的完整映射。它让不同数据流中的行情条件可被一致地解读与应用，确保用户能准确地把这些条件用于数据分析与报表。 |
results[].type | enum: sale_condition, quote_condition, sip_generated_flag, financial_status_indicator, short_sale_restriction_indicator, settlement_condition, market_condition, trade_thru_exempt | 一组相关条件的标识。 |
results[].update_rules | object | 聚合规则列表。 |
status | string | 本次请求响应的状态。 |
原文：Massive 文档 ↗