stk-managers

# 查询上市公司管理层信息 ## 接口说明 | 项目 | 说明 | |----------|---------------------------------------------------------| | 接口名称 | 查询上市公司管理层人员信息 | | 外部接口 | `/api/v1/market/data/stk-managers` | | 请求方式 | GET | | 适用场景 | 查询上市公司管理层人员，含姓名、岗位类别、职位、任职区间等 | ## 请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |-------------|--------|----------|-----------------------------------------------------|--------------|-----------------------------------------------------------------------| | trade_code | string | 是 | 股票代码 | 600848.SH | 带 .SZ/.SH 后缀，支持逗号分隔多个，如 `600848.SH,000001.SZ` | | candi_date | string | 否 | 候选日期，精确匹配 | 20251128 | `YYYYMMDD` 格式 | | begin_date | string | 否 | 任职起始日过滤 | 20200101 | `YYYYMMDD` 格式 | | end_date | string | 否 | 任职截止日过滤 | 20241231 | `YYYYMMDD` 格式；与 `begin_date` 同时提供时须 `begin_date` ≤ `end_date` | ## 执行方式 通过根目录的 `run.py` 调用（推荐）： ```bash python <RUN_PY> stk-managers --trade_code 600848.SH python <RUN_PY> stk-managers --trade_code 600848.SH --begin_date 20200101 --end_date 20241231 python <RUN_PY> stk-managers --trade_code 600848.SH,000001.SZ ``` > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径。 ## 响应结构 ```json [ { "trade_code": "000001.SZ", "security_name": "平安银行", "name": "杨运杰", "s_type": "董事", "position": "独立董事", "birth": "19660101", "candi_date": "20251128", "begin_date": "20260326", "end_date": "20281215", "is_job": "在任", "change_reason": "" } ] ``` ### 字段说明 | 字段名 | 类型 | 是否可为空 | 说明 | |-----------------|--------|------------|-------------------------------------------------| | trade_code | string | 否 | 股票代码（带 .SZ/.SH 后缀） | | security_name | string | 否 | 股票名称 | | name | string | 否 | 管理人员姓名 | | s_type | string | 否 | 岗位类别（如「高管」「董事」等） | | position | string | 否 | 职位 | | birth | string | 否 | 出生年月（`YYYYMMDD`） | | candi_date | string | 否 | 候选日期（`YYYYMMDD`） | | begin_date | string | 否 | 任职起始日（`YYYYMMDD`；空字符串表示无确切起始日）| | end_date | string | 否 | 任职截止日（`YYYYMMDD`；空字符串表示在职） | | is_job | string | 否 | 是否在职 | | change_reason | string | 否 | 变动原因 | ## 注意事项 - `trade_code` 必填，为空时接口返回 400。 - 不分页，单只股票一次性返回全部管理层记录；多 `trade_code`（逗号分隔）时合并返回。 - 日期参数格式为 `YYYYMMDD`，非时间戳。