File contents 查询 A 股行情列表（分页）
接口说明
项目
说明
接口名称
查询 A 股行情列表（分页）
外部接口
https://market.ft.tech/app/api/v2/stocks
请求方式
GET
适用场景
获取 A 股（沪深京）股票行情列表，支持按板块筛选、多字段排序与分页，用于行情中心「个股行情」等列表展示
请求头要求：必须携带 X-Client-Name: ft-web，否则返回参数错误。
请求参数
说明：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）
1 --- 2 name: stock-quotes-list 3 description: 查询 A 股行情列表（分页） 4 --- 5 # 查询 A 股行情列表（分页） 6 7 ## 接口说明 8 9 | 项目 | 说明 | 10 |---|---| 11 | 接口名称 | 查询 A 股行情列表（分页） | 12 | 外部接口 | `https://market.ft.tech/app/api/v2/stocks` | 13 | 请求方式 | GET | 14 | 适用场景 | 获取 A 股（沪深京）股票行情列表，支持按板块筛选、多字段排序与分页，用于行情中心「个股行情」等列表展示 | 15 16 请求头要求：必须携带 `X-Client-Name: ft-web`，否则返回参数错误。 17 18 ## 请求参数 19 20 说明：`order_by`、`page_no`、`page_size` 为必填项；`filter`、`masks` 为可选项，用于筛选与字段控制。 21 22 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | 23 |---|---|---|---|---|---| 24 | 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 | 25 | page_no | int | 是 | 页码，从 1 开始 | 1 | 必须大于等于 1 | 26 | page_size | int | 是 | 每页记录数 | 30 | 必须大于等于 1，建议不超过 100 | 27 | filter | string | 否 | 筛选条件表达式 | (ex_id = "XSHE" OR ex_id = "XSHG" OR ex_id = "BJSE") AND (latest != null) | 见下方「filter 常用取值」 | 28 | masks | string | 否 | 返回字段掩码/控制 | - | 不传则返回默认字段集 | 29 30 ### filter 常用取值（按板块） 31 32 | 板块 | filter 取值 | 33 |---|---| 34 | 全部股票 | (ex_id = "XSHE" OR ex_id = "XSHG" OR ex_id = "BJSE") AND (latest != null) | 35 | 上交主板 | ex_id = "XSHG" AND latest != null | 36 | 深交主板 | ex_id = "XSHE" AND latest != null | 37 | 北交主板 | ex_id = "BJSE" AND latest != null | 38 | 科创板 | board = "XSHG_STAR" AND latest != null | 39 | 创业板 | board = "XSHE_CHI_NEXT" AND latest != null | 40 41 ## 执行方式 42 43 通过根目录的 `run.py` 调用（推荐）： 44 45 ```bash 46 python <RUN_PY> stock-quotes-list --order_by "change_rate desc" --page_no 1 --page_size 30 47 ``` 48 49 可选参数：`--filter`、`--masks`。示例（仅科创板）： 50 51 ```bash 52 python <RUN_PY> stock-quotes-list --order_by "change_rate desc" --page_no 1 --page_size 30 --filter 'board = "XSHG_STAR" AND latest != null' 53 ``` 54 55 > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径，参见主 SKILL.md 的「调用方式」说明。 56 57 ## 响应说明 58 59 返回当前页股票列表及总条数，数据模型如下： 60 61 ```json 62 { 63 "total_size": 5000, 64 "stocks": [ { "StockInfo" } ] 65 } 66 ``` 67 68 ### 顶层字段 69 70 | 字段名 | 类型 | 是否可为空 | 说明 | 71 |---|---|---|---| 72 | total_size | int | 否 | 符合筛选条件的总记录数，用于分页计算 | 73 | stocks | array | 否 | 当前页股票列表，元素为 StockInfo | 74 75 ### StockInfo 结构 76 77 | 字段名 | 类型 | 是否可为空 | 说明 | 单位 | 78 |---|---|---|---|---| 79 | name | string | 是 | 股票名称 | - | 80 | symkey | string | 是 | 股票唯一标识，带市场后缀（如 920036.BJ、002445.SZ） | - | 81 | symbol_id | string | 是 | 证券代码（不含市场后缀） | - | 82 | ex_id | string | 是 | 交易所标识：XSHG（上交所）、XSHE（深交所）、BJSE（北交所） | - | 83 | board | string | 是 | 板块标识，如 XSHG_STAR（科创板）、XSHE_CHI_NEXT（创业板） | - | 84 | latest | number | 是 | 最新价 | 元 | 85 | open | number | 是 | 今开；非交易时段或未开盘时可能为空 | 元 | 86 | high | number | 是 | 最高价 | 元 | 87 | low | number | 是 | 最低价 | 元 | 88 | prev_close | number | 是 | 前收盘价 | 元 | 89 | close | number | 是 | 收盘价 | 元 | 90 | change | number | 是 | 涨跌额 | 元 | 91 | change_rate | number | 是 | 涨跌幅，小数值（如 0.1175 表示 11.75%） | 小数 | 92 | turnover | number | 是 | 成交额；非交易时段或停牌可为 0 | 元 | 93 | volume | number | 是 | 成交量（股）；前端常除以 100 显示为「手」 | 股 | 94 | market_cap_total | number | 是 | 总市值 | 元 | 95 | turnover_rate | number | 是 | 换手率，小数值（如 0.05 表示 5%）；非交易时段可为 0 | 小数 | 96 | change_rate_5d | number | 是 | 五日涨跌幅，小数值 | 小数 | 97 | amplitude | number | 是 | 振幅，小数值 | 小数 | 98 | limit_up | number | 是 | 涨停价 | 元 | 99 | limit_down | number | 是 | 跌停价 | 元 | 100 | is_in_default_choice_group | boolean | 是 | 是否在用户默认自选列表中；未登录时为 null | - | 101 | trading_status | string | 是 | 交易状态：LIMIT_UP（涨停）、LIMIT_DOWN（跌停）、NORMAL（正常） | - | 102 | symbol_status | object | 是 | 标的状态，含 base、extra 等 | - | 103 | margin_status | string | 是 | 融资融券状态：BOTH、NONE 等 | - | 104 | industry_sector | object | 是 | 行业板块，含 code、name | - | 105 106 ## 注意事项 107 108 - 涨跌幅、换手率、振幅等比率为小数值，展示时乘以 100 转为百分比 109 - `filter` 中含空格、引号、括号，通过 run.py 传参时需按 shell 规则正确引号包裹（如单引号包裹整段 filter）
dvcrn/openclaw-skills-marketplace/tree/main/plugins/shawn92--ftshare-market-data/skills/ftshare-market-data/sub-skills/stock-quotes-list commit c9af9cc264
Frequently asked questions How do I install the Stock Quotes List skill? Run npx skillmds@latest add dvcrn/stock-quotes-list in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Stock Quotes List skill do? 查询 A 股行情列表（分页） It is listed under Coding & Dev Tools on SkillMD.
Is Stock Quotes List safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Stock Quotes List? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Stock Quotes List free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Stock Quotes List? dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.
dvcrn