FTShare-Lab 查询 A 股行情列表（分页）
接口说明
| 项目 | 说明 |
|---|---|
| 接口名称 | 查询 A 股行情列表（分页） |
| 外部接口 | /api/v1/market/data/daec/stocks |
| 请求方式 | GET |
| 适用场景 | 获取 A 股（沪深京）股票行情列表，支持按板块筛选、多字段排序与分页，用于行情中心「个股行情」等列表展示 |
请求头要求：必须携带 X-Client-Name: ft-claw，否则返回参数错误。
请求参数
说明：order_by、page_no、page_size 为必填项；filter、masks 为可选项，用于筛选与字段控制。
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| order_by | string | 是 | 排序规则，格式为「字段 排序方向」 | change_rate desc | 常用：change_rate desc、change desc、latest desc、turnover desc、volume desc、market_cap_total desc、turnover_rate desc、change_rate_5d desc、amplitude desc；方向为 asc/desc |
| page_no | int | 是 | 页码，从 1 开始 | 1 | 必须大于等于 1 |
| page_size | int | 是 | 每页记录数 | 30 | 必须大于等于 1，建议不超过 100 |
| filter | string | 否 | 筛选条件表达式 | (ex_id = "XSHE" OR ex_id = "XSHG" OR ex_id = "BJSE") AND (latest != null) | 见下方「filter 常用取值」 |
| masks | string | 否 | 返回字段掩码/控制 | - | 不传则返回默认字段集 |
filter 常用取值（按板块）
| 板块 | filter 取值 |
|---|---|
| 全部股票 | (ex_id = "XSHE" OR ex_id = "XSHG" OR ex_id = "BJSE") AND (latest != null) |
| 上交主板 | ex_id = "XSHG" AND latest != null |
| 深交主板 | ex_id = "XSHE" AND latest != null |
| 北交主板 | ex_id = "BJSE" AND latest != null |
| 科创板 | board = "XSHG_STAR" AND latest != null |
| 创业板 | board = "XSHE_CHI_NEXT" AND latest != null |
执行方式
通过根目录的 run.py 调用（推荐）：
python <RUN_PY> stock-quotes-list --order_by "change_rate desc" --page_no 1 --page_size 30
可选参数：--filter、--masks。示例（仅科创板）：
python <RUN_PY> stock-quotes-list --order_by "change_rate desc" --page_no 1 --page_size 30 --filter 'board = "XSHG_STAR" AND latest != null'
<RUN_PY>为主SKILL.md同级的run.py绝对路径，参见主 SKILL.md 的「调用方式」说明。
响应说明
返回当前页股票列表及总条数，数据模型如下：
{
"total_size": 5000,
"stocks": [ { "StockInfo" } ]
}
顶层字段
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| total_size | int | 否 | 符合筛选条件的总记录数，用于分页计算 |
| stocks | array | 否 | 当前页股票列表，元素为 StockInfo |
StockInfo 结构
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| name | string | 是 | 股票名称 | - |
| symkey | string | 是 | 股票唯一标识，带市场后缀（如 920036.BJ、002445.SZ） | - |
| symbol_id | string | 是 | 证券代码（不含市场后缀） | - |
| ex_id | string | 是 | 交易所标识：XSHG（上交所）、XSHE（深交所）、BJSE（北交所） | - |
| board | string | 是 | 板块标识，如 XSHG_STAR（科创板）、XSHE_CHI_NEXT（创业板） | - |
| latest | number | 是 | 最新价 | 元 |
| open | number | 是 | 今开；非交易时段或未开盘时可能为空 | 元 |
| high | number | 是 | 最高价 | 元 |
| low | number | 是 | 最低价 | 元 |
| prev_close | number | 是 | 前收盘价 | 元 |
| close | number | 是 | 收盘价 | 元 |
| change | number | 是 | 涨跌额 | 元 |
| change_rate | number | 是 | 涨跌幅，小数值（如 0.1175 表示 11.75%） | 小数 |
| turnover | number | 是 | 成交额；非交易时段或停牌可为 0 | 元 |
| volume | number | 是 | 成交量（股）；前端常除以 100 显示为「手」 | 股 |
| market_cap_total | number | 是 | 总市值 | 元 |
| turnover_rate | number | 是 | 换手率，小数值（如 0.05 表示 5%）；非交易时段可为 0 | 小数 |
| change_rate_5d | number | 是 | 五日涨跌幅，小数值 | 小数 |
| amplitude | number | 是 | 振幅，小数值 | 小数 |
| limit_up | number | 是 | 涨停价 | 元 |
| limit_down | number | 是 | 跌停价 | 元 |
| is_in_default_choice_group | boolean | 是 | 是否在用户默认自选列表中；未登录时为 null | - |
| trading_status | string | 是 | 交易状态：LIMIT_UP（涨停）、LIMIT_DOWN（跌停）、NORMAL（正常） | - |
| symbol_status | object | 是 | 标的状态，含 base、extra 等 | - |
| margin_status | string | 是 | 融资融券状态：BOTH、NONE 等 | - |
| industry_sector | object | 是 | 行业板块，含 code、name | - |
注意事项
- 涨跌幅、换手率、振幅等比率为小数值，展示时乘以 100 转为百分比
filter中含空格、引号、括号，通过 run.py 传参时需按 shell 规则正确引号包裹（如单引号包裹整段 filter）