查询板块资金贡献明细
signal.trading_contributors.list
查询用于板块资金确认计算的映射公司和聚合权重。
调用契约
| 项目 | 值 |
|---|---|
| Method | GET |
| Path | /api/gendangzou/sectors/{sector_id}/trading-contributors |
| 业务域 | signal |
| 数据更新 | 随交易日数据和完整数据版本发布 |
受控意图：inspect_market_confirmation、audit_trading_signal
请求参数
| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
|---|---|---|---|---|
sector_id | path | string | 是 | 最短 3 字符；最长 128 字符 |
page | query | integer | 否 | 从 1 开始的页码；默认 1；最小 1 |
page_size | query | integer | 否 | 默认 20；最小 1；最大 100 |
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>/trading-contributors?page_size=10&detail=compact"将路径中的 <...> 替换为实际资源 ID。
响应
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
snapshot | SnapshotContext / SnapshotReference | 是 | 本次查询实际使用的数据版本。 |
sector_id | string | 是 | 板块稳定标识。 |
summary | TradingSummary | 是 | 当前查询的聚合统计。 |
items | array<TradingContributor> | 是 | 当前查询返回的结果列表。 |
pagination | Pagination | 是 | 分页位置、总数和总页数。 |
TradingSummary
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
trade_date | string | 是 | - |
provider | string | 是 | - |
formula_version | string | 是 | - |
confirmation_score | number | 是 | - |
momentum | number | 是 | 相对上一可比版本的变化量。 |
activity_score | number | 是 | - |
buying_pressure | number | 是 | - |
liquidity_score | number | 是 | - |
trading_intensity | number | 否 | - |
direction_score | number | 否 | 方向强度，正值、负值和零分别表示正向、负向和中性。 |
direction_coverage | number | 否 | - |
direction_momentum | number | 否 | - |
positive_score | number | 否 | - |
negative_score | number | 否 | - |
neutral_score | number | 否 | - |
breadth_score | number | 是 | - |
confidence | number | 是 | 结果置信度；不能与关系分或热度分互换。 |
mapped_stock_count | integer | 是 | - |
covered_stock_count | integer | 是 | - |
coverage_ratio | number | 是 | - |
concentration | number | 是 | - |
confirmed_mapped_stock_count | integer | 否 | - |
candidate_mapped_stock_count | integer | 否 | - |
confirmed_covered_stock_count | integer | 否 | - |
candidate_covered_stock_count | integer | 否 | - |
confirmed_coverage_ratio | number | 否 | - |
candidate_coverage_ratio | number | 否 | - |
confirmed_sample_share | number | 否 | - |
candidate_sample_share | number | 否 | - |
confirmed_weight_share | number | 否 | - |
candidate_weight_share | number | 否 | - |
candidate_weight_cap | number | 否 | - |
effective_sample_size | number | 否 | - |
mapping_support | number | 否 | - |
TradingContributor
| 字段 | 类型 | 必有 | 含义 |
|---|---|---|---|
stock_code | string | 是 | 保留前导零的六位 A 股代码。 |
stock_name | string | 是 | 上市公司简称。 |
exchange | string | 是 | 上市交易所。 |
board | string | 是 | A 股上市板标识。 |
relation_id | string | 是 | 公司与板块关系的稳定标识，用于继续查询证据。 |
relation_type | string | 是 | 公司与板块的业务关系或市场关系。 |
mapping_status | string | 否 | 用于资金聚合的公司映射状态。 |
mapping_weight | number | 是 | 公司关系进入资金聚合前的映射权重。 |
aggregation_weight | number | 是 | - |
status_weight | number | 否 | - |
relation_weight | number | 否 | - |
effective_weight | number | 否 | - |
impact_direction | string | 否 | 材料对板块的正向、负向、中性或未知方向。 |
amount | number | 是 | - |
pct_change | number / null | 否 | - |
activity_score | number | 是 | - |
buying_pressure | number | 是 | - |
liquidity_score | number | 是 | - |
trading_intensity | number | 否 | - |
direction_score | number | 否 | 方向强度，正值、负值和零分别表示正向、负向和中性。 |
direction_coverage | number | 否 | - |
confirmation_score | number | 是 | - |
contribution_score | number | 是 | 该公司对板块资金确认的贡献。 |
directional_contribution | number | 否 | - |
confidence | number | 是 | 结果置信度；不能与关系分或热度分互换。 |
调用要点
- Agent 建议使用
detail=compact控制上下文体积。 - 分页从
page_size=10开始，确认需要后再继续翻页。 - 需要解释结论时，再调用关联证据能力。