| name | stock-filter |
| description | A 股实时行情筛选接口。当用户需要按单标的代码(symbol)精确查询,或按板块/交易所(board)+ 上市日期起点(listing_date_since)筛选实时行情时使用。传入 symbol 时忽略 board 与 listing_date_since。 |
A 股实时行情筛选
接口说明
| 项目 | 说明 |
|---|
| 接口名称 | A 股实时行情筛选 |
| 外部接口 | /api/v1/market/data/stock-list/filter |
| 请求方式 | GET |
| 适用场景 | A 股实时行情快照筛选,支持按单标的代码或板块+上市日期筛选 |
请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|
| symbol | string | 否 | 单标的代码 | 600519.SH | 支持裸码或带后缀(.SH/.XSHG/.SZ/.XSHE/.BJ/.BJSE);传入后忽略 board 与 listing_date_since |
| board | string | 否 | 板块/交易所筛选 | star | star 科创板 / chi_next 创业板 / bjse 北交所 / xshg 沪市 / xshe 深市 / main 主板 |
| listing_date_since | string | 否 | 上市日期起点 | 20200101 | YYYYMMDD,筛选此后上市的股票 |
| page | uint32 | 否 | 页码 | 1 | 不设默认/上限,原样透传 |
| page_size | uint32 | 否 | 每页记录数 | 50 | 不设默认/上限,原样透传 |
执行方式
通过根目录的 run.py 调用(推荐):
python <RUN_PY> stock-filter --symbol 600519.SH --page 1 --page_size 5
python <RUN_PY> stock-filter --board star --page 1 --page_size 5
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。
响应结构
返回扁平分页结构(无 code/message 信封):
{
"items": [
{
"type": "stock",
"symbol": "688556.SH",
"symbol_id": "688556",
"symbol_name": "高测股份",
"board": "sh_star",
"close": "8.5100",
"open": "9.2200",
"high": "9.2200",
"low": "8.5000",
"prev_close": "9.2200",
"change": "-0.7100",
"change_rate": -0.077,
"amplitude": 0.0781,
"volume": 28312089,
"turnover": "250052129.1700",
"change_rate_day5": -0.212,
"change_rate_day10": -0.0301,
"change_rate_day20": -0.2996,
"change_rate_day60": -0.3459,
"change_rate_ytd": -0.2469,
"ts_nanos": 1756704000000000000
}
],
"total_pages": 122,
"total_items": 610
}
顶层字段说明
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|
| items | Array | 否 | 股票行情列表 |
| total_pages | int | 否 | 总页数 |
| total_items | int | 否 | 总记录数 |
items 元素字段
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|
| type | string | 否 | 标的类型(恒为 stock) |
| symbol | string | 否 | 标的代码(带交易所后缀) |
| symbol_id | string | 否 | 标的 ID(纯数字代码) |
| symbol_name | string | 否 | 标的名称 |
| board | string | 是 | 板块枚举:sh / sz / sz_chi_next / sh_star / bj |
| close | string | 是 | 收盘价/最新价(元) |
| open | string | 是 | 开盘价(元) |
| high | string | 是 | 最高价(元) |
| low | string | 是 | 最低价(元) |
| prev_close | string | 是 | 前收盘价(元) |
| change | string | 是 | 涨跌额(元) |
| change_rate | float | 是 | 涨跌幅(原始小数,-0.077 表示 -7.7%) |
| amplitude | float | 是 | 振幅 =(最高-最低)/前收盘 |
| volume | int64 | 是 | 成交量(股) |
| turnover | string | 是 | 成交额(元) |
| change_rate_day5 | float | 是 | 5 日涨跌幅 |
| change_rate_day10 | float | 是 | 10 日涨跌幅 |
| change_rate_day20 | float | 是 | 20 日涨跌幅 |
| change_rate_day60 | float | 是 | 60 日涨跌幅 |
| change_rate_ytd | float | 是 | 年初至今涨跌幅 |
| ts_nanos | int64 | 是 | 交易所时间戳(纳秒) |
注意事项
- 必须至少指定
--symbol 或 --board/--listing_date_since 其一。
- 传入
--symbol 时直接按单标的查询,忽略 --board 与 --listing_date_since。
- 请求
board 取值与响应 board 枚举不同:请求用 star/chi_next/bjse/xshg/xshe/main,响应用 sh/sz/sz_chi_next/sh_star/bj。
- 涨跌幅等比率为原始小数(如 -0.077 表示 -7.7%)。
- 金额字段以字符串返回,保持精度。
- 始终排除退市股与无行情股。