---
title: "查询板块资金贡献明细"
description: "查询用于板块资金确认计算的映射公司和聚合权重。"
pageClass: gendangzou-doc
---

# 查询板块资金贡献明细

`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` 开始，确认需要后再继续翻页。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`signal.heat.rank`](/zh/gendangzou/capabilities/signal.heat.rank)
- [`company.by_sector.list`](/zh/gendangzou/capabilities/company.by_sector.list)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/signal.trading_contributors.list)