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

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 对象。

{
  "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 调用：

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)。
• 按合同总额降序排列。