Major contract summary

Skill FTShare-Lab/FTShare-skills/ftshare-market-data/sub-skills/major-contract-summary

FTShare Agent Skills for financial data and investment research workflows｜金融数据 Skill 与投研业务 Skill 仓库。

Install

npx -y skills add FTShare-Lab/FTShare-skills --skill major-contract-summary

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

近一年A股个股重大合同汇总排名（market.ft.tech）。用户问重大合同排行榜、哪些公司签合同最多/金额最大、合同总额排名时使用。

SKILL.md

2.4 KB, as published. Nobody here has run it

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

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