# Major Contract Summary

> Major Contract Summary

- Skill: `ftshare-lab/major-contract-summary` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ftshare-lab/major-contract-summary`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ftshare-lab/major-contract-summary/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: FTShare-Lab (https://skillmd.com/u/ftshare-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ftshare-lab/major-contract-summary

---


# 重大合同 - 近一年个股汇总

## 1. 接口描述

| 项目 | 说明 |
|------|------|
| 接口名称 | 近一年个股重大合同汇总 |
| 外部接口 | `GET /api/v1/market/data/corporate/contract/summary` |
| 请求方式 | GET |
| 适用场景 | 近一年各股票重大合同数量与金额汇总排名，按合同总额降序，支持分页 |

## 2. 请求参数

| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|--------|------|----------|------|----------|------|
| page | int | 否 | 页码，从 1 开始 | `1` | 默认 1 |
| page_size | int | 否 | 每页数量 | `50` | 默认 50，最大 200 |

## 3. 响应说明

返回 `PaginatedApiResponse` 包装的 JSON 对象。

```json
{
  "code": 0,
  "message": "success",
  "data": {
    "pageNum": 1,
    "pageSize": 50,
    "total": 35,
    "pages": 1,
    "records": [
      {
        "seq": 0,
        "security_code": "002307",
        "security_short_name": "北新路桥",
        "contract_count": "1",
        "total_amount": "3249000000.0000",
        "prev_year_total": "3249000000.0000",
        "last_year_revenue": null,
        "revenue_ratio": null,
        "latest_revenue": null
      }
    ]
  }
}
```

### data.records 元素结构

| 字段名 | 类型 | 说明 |
|--------|------|------|
| seq | int | 序号 |
| security_code | string | 股票代码 |
| security_short_name | string | 股票简称 |
| contract_count | string | 重大合同签署数量 |
| total_amount | string | 合同金额总计（元） |
| prev_year_total | string | 上年度合同金额总计（元） |
| last_year_revenue | string | 上年度营业收入（元） |
| revenue_ratio | string | 占上年营业收入比例（%） |
| latest_revenue | string | 最新财务报表营业收入（元） |

## 4. 用法

通过主目录 `run.py` 调用：

```bash
python <RUN_PY> major-contract-summary
python <RUN_PY> major-contract-summary --page 1 --page_size 50
```

## 5. 请求示例

```
GET /api/v1/market/data/corporate/contract/summary?page=1&page_size=50
```

## 6. 注意事项

- 近一年范围 = `dim_rdate >= DATE_SUB(NOW(), INTERVAL 1 YEAR)`。
- 按合同总额降序排列。