获取板块详情
sector.detail
读取板块定义、边界、层级、生命周期和当前三类信号。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/sectors/{sector_id} |
| 业务域 | sector |
| 数据更新 | 随完整数据版本发布 |
受控意图：analyze_sector、explain_sector、inspect_sector_boundary
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
sector_id | path | string | 是 | 最短 3 字符；最长 128 字符 |
snapshot_id | query | string | 否 | 最短 8 字符；最长 128 字符 |
as_of | query | string | 否 | 返回此日期或此前最近的完整快照；格式 date |
detail | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 full；可选 full、compact |
include | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |
最小调用
bash
curl --fail --silent --show-error \
-H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
"https://api.mobiusquant.ai/api/gendangzou/sectors/<sector_id>?detail=compact"将路径中的 <...> 替换为实际资源 ID。
响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
snapshot | SnapshotContext / SnapshotReference | 是 | 本次查询实际使用的数据版本。 |
sector | SectorDetail | 是 | 板块详情。 |
SectorDetail
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
sector_id | string | 是 | 板块稳定标识。 |
name | string | 是 | 对象名称。 |
layer | string | 是 | 板块层级。 |
status | string | 是 | 对象或关系的当前状态。 |
object_type | string | 是 | 板块对象类型。 |
parent_id | string / null | 否 | 直接上级板块标识。 |
parent_name | string / null | 否 | 直接上级板块名称。 |
source_origin | string | 是 | 板块定义的来源类型。 |
activation_weight | number | 是 | 板块当前激活权重。 |
definition | string | 否 | 板块定义。 |
aliases | array<string> | 否 | 板块历史名称和常用别名。 |
include | array<string> | 否 | 纳入板块定义的业务边界。 |
exclude | array<string> | 否 | 明确不属于该板块的业务边界。 |
related_parents | array<string> | 否 | - |
mapped_sw | array<string> | 否 | - |
lifecycle | SectorLifecycle | 否 | 板块生命周期状态和关键日期。 |
policy_heat | HeatValue / null | 否 | 板块的政策热度。 |
market_attention | HeatValue / null | 否 | 板块的即时市场关注度。 |
market_trading | HeatValue / null | 否 | 板块的资金确认度。 |
children | array<SectorSummary> | 否 | 板块的直接下级节点。 |
relationships | array<SectorRelationship> | 否 | 该板块的一跳层级、产业和演化关系。 |
changes | array<SectorChange> | 否 | 该板块的历史变更记录。 |
successor_ids | array<string> | 否 | - |
taxonomy_evidence_count | integer | 否 | - |
heat_evidence_count | integer | 否 | - |
SectorLifecycle
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
state | string | 否 | - |
current_in_snapshot | boolean | 否 | 该板块是否存在于本次数据版本。 |
first_seen_as_of | string | 否 | - |
last_seen_as_of | string | 否 | - |
last_supported_as_of | string | 否 | - |
last_active_as_of | string | 否 | - |
inactive_since | string | 否 | - |
inactive_reason | string | 否 | - |
reactivated_as_of | string | 否 | - |
HeatValue
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
level | number | 是 | - |
momentum | number | 是 | 相对上一可比版本的变化量。 |
contribution_count | integer | 否 | 进入当前热度计算的贡献项数量。 |
SectorSummary
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
sector_id | string | 是 | 板块稳定标识。 |
name | string | 是 | 对象名称。 |
layer | string | 是 | 板块层级。 |
status | string | 是 | 对象或关系的当前状态。 |
object_type | string | 是 | 板块对象类型。 |
parent_id | string / null | 否 | 直接上级板块标识。 |
parent_name | string / null | 否 | 直接上级板块名称。 |
source_origin | string | 是 | 板块定义的来源类型。 |
activation_weight | number | 是 | 板块当前激活权重。 |
definition | string | 否 | 板块定义。 |
aliases | array<string> | 否 | 板块历史名称和常用别名。 |
include | array<string> | 否 | 纳入板块定义的业务边界。 |
exclude | array<string> | 否 | 明确不属于该板块的业务边界。 |
related_parents | array<string> | 否 | - |
mapped_sw | array<string> | 否 | - |
lifecycle | SectorLifecycle | 否 | 板块生命周期状态和关键日期。 |
policy_heat | HeatValue / null | 否 | 板块的政策热度。 |
market_attention | HeatValue / null | 否 | 板块的即时市场关注度。 |
market_trading | HeatValue / null | 否 | 板块的资金确认度。 |
SectorRelationship
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
source_sector_id | string | 是 | - |
source_sector_name | string | 是 | - |
target_sector_id | string | 是 | - |
target_sector_name | string | 是 | - |
relation | string | 是 | 板块节点之间的关系类型。 |
direction | string | 是 | - |
confidence | string | 否 | 结果置信度；不能与关系分或热度分互换。 |
rationale | string | 否 | 当前判断或关系的依据。 |
effective_from | string | 否 | - |
lifecycle_relation | boolean | 否 | - |
SectorChange
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
change_id | string | 是 | - |
effective_from | string | 是 | - |
change_type | string | 是 | - |
before | object | 否 | - |
after | object | 否 | - |
rationale | string | 否 | 当前判断或关系的依据。 |
调用要点
- Agent 建议使用
detail=compact控制上下文体积。 - 需要解释结论时，再调用关联证据能力。