# 跟党走 API

> 面向 A 股板块研究的查询 API，提供连续实时材料流、权威材料、板块、三类信号、公司映射、ETF 映射和可溯源证据。
> API Base: https://api.mobiusquant.ai/api/gendangzou
> Contract: gendangzou-api-v2

## Agent 起点

1. 调用 `GET https://api.mobiusquant.ai/api/gendangzou/bootstrap` 探测鉴权和版本。
2. 调用 `GET https://api.mobiusquant.ai/api/gendangzou/capabilities`，使用 `domain` 或 `intent` 缩小范围。
3. 调用与任务匹配的能力，读取最新可用数据。
4. 跨接口一致性或历史回看时使用 `snapshot.latest` 并复用 `snapshot_id`。
5. 先取板块结论，只有用户要求依据时才读取证据。

## 文档入口

- [总览](https://docs.mobiusquant.ai/zh/gendangzou/index.md)
- [快速开始](https://docs.mobiusquant.ai/zh/gendangzou/quickstart.md)
- [信源列表](https://docs.mobiusquant.ai/zh/gendangzou/data-sources.md)
- [数据时效与时间字段](https://docs.mobiusquant.ai/zh/gendangzou/data-freshness.md)
- [Agent 工作流](https://docs.mobiusquant.ai/zh/gendangzou/workflows.md)
- [权威材料与证据链](https://docs.mobiusquant.ai/zh/gendangzou/materials-and-evidence.md)
- [板块与三类信号](https://docs.mobiusquant.ai/zh/gendangzou/sector-signals.md)
- [板块与公司映射](https://docs.mobiusquant.ai/zh/gendangzou/company-mapping.md)
- [ETF 与板块映射](https://docs.mobiusquant.ai/zh/gendangzou/etf-mapping.md)
- [快照与历史版本](https://docs.mobiusquant.ai/zh/gendangzou/snapshots-and-history.md)
- [错误、限流与重试](https://docs.mobiusquant.ai/zh/gendangzou/errors-and-retries.md)
- [机器可读能力清单](https://docs.mobiusquant.ai/zh/gendangzou/agent-manifest.json)

## 稳定能力 ID

- [system.bootstrap](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/system.bootstrap.md): Skill 的固定入口；无需鉴权即可判断认证模式并定位能力目录。
- [system.capabilities](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/system.capabilities.md): 按业务域或受控意图查询精简能力索引，再按能力 ID 获取详情。
- [material.policy.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/material.policy.list.md): 查询指定自然日已完成分析的政府和监管机构材料。
- [material.media.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/material.media.list.md): 查询指定自然日已完成分析的国家级通讯社和高置信媒体材料。
- [sector.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.list.md): 按层级、父级、状态或名称查询自有 A 股板块目录。
- [sector.detail](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.detail.md): 读取板块定义、边界、层级、生命周期和当前三类信号。
- [sector.graph](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.graph.md): 返回选中板块的一跳层级、产业、演化和市场关联。
- [sector.heat_series](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.heat_series.md): 按政策、市场关注或资金确认维度查询板块历史轨迹。
- [signal.realtime.overview](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.realtime.overview.md): 按独立滚动时间窗口查询政策、权威媒体和即时市场关注事件流，同时返回板块聚合与可溯源材料；日报快照不会重置该窗口。
- [signal.realtime.sectors](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.realtime.sectors.md): 按1小时、6小时、24小时或3天滚动窗口分别聚合政策、权威媒体和即时市场关注强度，并与前一个等长窗口比较。
- [signal.realtime.events](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.realtime.events.md): 按游标持续读取已完成分析的政策、权威媒体和即时财经材料，支持按板块、信源类型和滚动窗口过滤。
- [signal.heat.rank](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.heat.rank.md): 分别查询政策热度、市场关注度或资金确认度，不合并三类口径。
- [signal.dynamics.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.dynamics.list.md): 返回板块级横截面异动、内部确认和同日产业关联。
- [signal.trading_contributors.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.trading_contributors.list.md): 查询用于板块资金确认计算的映射公司和聚合权重。
- [security.lifecycle.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/security.lifecycle.list.md): 按北京时间日期查询待上市、近期上市及退出证券，并返回板块关联和权威来源。
- [security.lifecycle.changes](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/security.lifecycle.changes.md): 查询待上市、正式上市、终止上市和退市的权威状态变化。
- [company.search](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.search.md): 按股票代码、股票简称或公司全称搜索沪深北A股公司，并返回证券生命周期及当前板块关系摘要。
- [company.by_sector.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.by_sector.list.md): 按关系类型、状态和最低关系分查询板块公司映射。
- [company.sectors.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.sectors.list.md): 按股票代码查询最新有效版本中的多对多板块关系。
- [company.detail](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.detail.md): 返回公司市场标识及其当前有效、观察中和候选板块关系。
- [etf.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.list.md): 按代码、名称、交易所、产品范围或跟踪指数查询 ETF。
- [etf.detail](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.detail.md): 返回 ETF 产品元数据、跟踪指数及可追溯板块暴露。
- [etf.sectors.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.sectors.list.md): 依据官方申赎篮子、跟踪指数、公司关系和板块路径，查询 ETF 的直接或扩展板块关系。
- [etf.by_sector.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.by_sector.list.md): 按板块查询直接映射、血缘扩展和上级参考 ETF，各类关系分开标识且不构成产品推荐。
- [etf.relation.evidence](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.evidence.md): 返回官方 PCF、跟踪指数匹配、板块路径、计算公式和主要成分贡献摘要。
- [etf.relation.contributions](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.contributions.md): 分页返回每个篮子成分、公司板块关系及其对调整暴露的完整贡献。
- [etf.relation.changes](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.changes.md): 返回关系创建、状态跨档、显著暴露变化和失效事件，并说明变化来源。
- [evidence.sector.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.sector.list.md): 查询板块生成、政策热度、市场关注和资金确认的可溯源依据。
- [evidence.relation.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.relation.list.md): 按关系 ID 查询底层事实证据，用于细粒度审计。
- [evidence.relation_materials.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.relation_materials.list.md): 将同一文档中的公司业务事实归并展示，是 Agent 的推荐映射审计接口。
- [evidence.company.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.company.list.md): 按股票代码查询全部关系证据，可进一步限定板块。
- [snapshot.list](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/snapshot.list.md): 按日期区间返回可复现的完整发布快照。
- [snapshot.latest](https://docs.mobiusquant.ai/zh/gendangzou/capabilities/snapshot.latest.md): 获取最新快照，或指定日期之前最近的完整快照。