$npx -y skills add FTShare-Lab/FTShare-skills --skill block-trades查询大宗交易列表。当用户需要获取 A 股大宗交易记录,包含买卖方营业部、成交价、成交量、溢价率等,或了解大宗交易列表时使用。
| 1 | # 查询大宗交易列表 |
| 2 | |
| 3 | ## 接口说明 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |---|---| |
| 7 | | 接口名称 | 查询大宗交易列表 | |
| 8 | | 外部接口 | `/api/v1/market/data/block-trades` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取 A 股大宗交易记录,包含买卖方营业部、成交价、成交量、溢价率等 | |
| 11 | |
| 12 | ## 请求参数 |
| 13 | |
| 14 | 无需任何参数。 |
| 15 | |
| 16 | ## 执行方式 |
| 17 | |
| 18 | 通过根目录的 `run.py` 调用(推荐): |
| 19 | |
| 20 | ```bash |
| 21 | python <RUN_PY> block-trades |
| 22 | ``` |
| 23 | |
| 24 | > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径,参见主 SKILL.md 的「调用方式」说明。 |
| 25 | |
| 26 | ## 响应结构 |
| 27 | |
| 28 | 返回值为大宗交易记录数组(直接返回数组,非对象包装): |
| 29 | |
| 30 | ```json |
| 31 | [ |
| 32 | { |
| 33 | "symbol": "000001.SZ", |
| 34 | "name": "平安银行", |
| 35 | "date": "2025-03-10", |
| 36 | "price": "10.50", |
| 37 | "close": "10.48", |
| 38 | "volume": 1000000, |
| 39 | "premium_rate": 0.19, |
| 40 | "buyer_name": "某某营业部", |
| 41 | "seller_name": "某某证券营业部" |
| 42 | } |
| 43 | ] |
| 44 | ``` |
| 45 | |
| 46 | ### 字段说明(BlockTrade) |
| 47 | |
| 48 | | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | |
| 49 | |---|---|---|---|---| |
| 50 | | `symbol` | String | 否 | 标的代码,带市场后缀 | - | |
| 51 | | `name` | String | 否 | 标的名称 | - | |
| 52 | | `date` | String | 否 | 成交日期,格式 `YYYY-MM-DD` | - | |
| 53 | | `price` | Number | 否 | 成交价 | 元 | |
| 54 | | `close` | Number | 否 | 收盘价 | 元 | |
| 55 | | `volume` | int | 否 | 成交量 | 股 | |
| 56 | | `premium_rate` | Number | 否 | 溢价率(小数形式,如 `0.19` 表示 19%) | - | |
| 57 | | `buyer_name` | String | 否 | 买方营业部名称 | - | |
| 58 | | `seller_name` | String | 否 | 卖方营业部名称 | - | |
| 59 | |
| 60 | ## 注意事项 |
| 61 | |
| 62 | - 接口直接返回数组,无分页包装结构 |
| 63 | - `premium_rate` 为小数形式,展示时乘以 100 转为百分比 |
| 64 | - `price` 和 `close` 在文档中标注为 Number,但部分情况可能以字符串返回,比较前注意类型转换 |