Menu
A 股实时行情筛选接口。当用户需要按单标的代码（symbol）精确查询，或按板块/交易所（board）+ 上市日期起点（listing_date_since）筛选实时行情时使用。传入 symbol 时忽略 board 与 listing_date_since。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | stock-filter |
| description | A 股实时行情筛选接口。当用户需要按单标的代码（symbol）精确查询，或按板块/交易所（board）+ 上市日期起点（listing_date_since）筛选实时行情时使用。传入 symbol 时忽略 board 与 listing_date_since。 |
| 项目 | 说明 |
|---|---|
| 接口名称 | 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 | 否 | 总记录数 |
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| 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。非凸科技金融数据技能集。覆盖 A 股股票列表、全字段/实时行情列表、分时价格、IPO、大宗交易、融资融券、单股行情估值、可转债、ETF、基金、指数（含分页指数描述、下载描述 PDF、权重汇总/成份明细、下载权重 xlsx、详情/K 线/分时）、宏观经济，以及港股公司介绍/估值分析/基础视图/K线、东财美股列表/历史K线/最新行情、native 美股基础信息/利润表/现金流量表/资产负债表、港股财报三表(利润/现金流/资产负债)/东财港股指数日K线等接口（market.ft.tech / ftai.chat）。用户询问 A 股、港股、美股的代码、行情、估值、K线、指数权重/描述、新闻与宏观数据时使用。
按日期范围查询财经日历（market.ft.tech），含华尔街见闻与百度财经日历数据（宏观数据、IPO、财报时间、交易提醒等）。用户问财经日历、经济事件、IPO 日程、财报时间、交易提醒时使用。
查询所有期股权质押总揽数据。当用户需要获取 A 股市场所有报告期的股权质押总揽数据，包括质押公司数量、质押笔数、质押总股数、质押总市值、沪深300指数等信息，支持沪深京股票，或了解所有期股权质押总揽数据时使用。
批量获取多只可转债 K 线 POST 接口（market.ft.tech，convertible-bond-candlesticks/batch）。用户问多只可转债的 K 线、批量可转债日 K/周 K/月 K/年 K 时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
单只可转债历史 K 线 POST 接口（market.ft.tech，convertible-bond-candlesticks）。用户问某只可转债的分/日/周/月/年 K 线、开高低收、前/后复权、分钟级 K 线时使用。必填 --symbol、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。
批量获取多只 ETF 历史 K 线 POST 接口（market.ft.tech，etf-candlesticks/batch）。用户问多只 ETF 的 K 线、批量 ETF 日 K/周 K/月 K/年 K、510300 和 159915 一起的 K 线时使用。必填 --symbols、--interval-unit、--until-ts-millis；可选 --interval-value、--adjust-kind、--since-ts-millis、--limit。