选股(条件筛选 / 主题池 / 排行 / 策略 / 事件) API
按条件筛出股票清单。五个模式,用 mode 选(默认 filter): mode=filter(默认)条件筛选 —— filters=pe_ttm:0..20,roe_ttm:>=15 · 逗号分隔 = AND(同时满足);区间写 0..20(含两端),比较写 >=15 / <=30 / >0 / <0 / =5 · 可用字段 94 个(估值 / 行情 / 盈利 / 资产负债 / 现金流),清单见 list=fields(带中文名与单位)—— ⛔ 不要凭猜填字段名,写错会 422 并告诉你可用清单 · 排序:sort=roe_ttm(降序)· sort=-roe_ttm(升序,- 前缀) · 股票池:board=hs300 | zz500 | zz1000 | sse50 | sz_component;不传即全市场(没有 all 这个值,不传就行) · 官方预设:preset=low_pe(22 个,清单见 list=presets)—— 与 filters 二选一 · 历史截面:加 date=2026-11-06 取该交易日符合条件的股票(可直接做回测) mode=pool 主题池 / 属性标签:央企/国企/民企/QFII、ST/退市/破发、破净、亏损、现金流结构、上市时间、市值档位…(108 个);asset=etf 切 ETF 主题池(48 个:千亿/500 亿/百亿基金、金牛奖、新发 3 月内…)。 mode=rank 全市场排行:metric=overall | capital | fundamental | risk | technical(综合 / 资金 / 基本面 / 风险 / 技术评分,默认 overall)。 mode=strategy 技术/风格策略:MACD金叉、KDJ金叉、突破年线、首次涨停、连板、高股息、高盈利价值、大师策略(巴菲特/格雷厄姆/费雪…)共 98 个。 mode=event 事件驱动:分红预案/决案/实施/除权、业绩预告/快报/披露、定增上市前后、董监高变更与增减持、大宗交易、解禁…(共 42 个)。 ⭐ 不知道有哪些取值?用 list= 自发现(⛔ 不要凭猜填): list=fields 筛选字段 · list=boards 股票池 · list=presets 预设 · list=metrics 排行指标 · list=pools 主题池 · list=strategies 策略 · list=events 事件 · list=true 列出当前模式的全部取值(带中文名与分组)。 返回:data 排版好的表格 · structured 第一张表(程序化读取用这个)· tables 全部段(多标签/多策略会分多段,每段一张表)· trace_id 本次请求编号(报障时给这个就够了,我们据此还原全链路)。 ⭐ 风险标记(ST / 退市整理期):结果末尾多一列 风险标记(取值 - / ST / 退市整理);structured 每行同时带 isST(布尔)/ isDelisting(布尔)/ status(normal / ST / delisting)。 · 用途:低 PE / 低 PB 这类因子排序时,退市整理期与 ST 股常占据前排(实测 preset=low_pe 第一只是 萃华退),有这列就能自行排除。 · ⛔ 我们不做隐式过滤 —— 标记给出,排不排由您决定(否则您的回测无法复现)。 · ⚠️ 停牌未标注:数据源没有停牌维度,也无法用「涨跌幅为 0」推断(正常股也会出现 0)⇒ 宁可不标,不给错标记。 取数规模:filter 的 limit 没有上限 —— 传 limit=9999 一次取全市场 5000+ 只(约 1.6 MB,1~2 秒),计费仍按 1 次请求算;filter 一次就能取全,不需要翻页。 其余模式(pool/rank/strategy/event)单页上限 200,用 offset 翻页。 ⚠️⚠️ asset=etf 的三条边界(实测 2026-10-23,⛔ 别当成「筛过了」): ① filter(因子筛选)与 strategy(技术/风格策略)不支持 ETF —— 传了会 422; ② rank 只有「排序」,没有「条件过滤」 —— 阈值参数在 ETF 模式下不生效(实测设一个不可能达到的阈值仍返回全部 1716 只)⇒ 要筛 ETF 只能客户端自己过滤; ③ pool 是唯一的「真筛选」入口,但只有 48 个固定主题池,不能自定义条件。 ⭐ 替代做法:mode=rank&asset=etf&metric=overall 用 limit=200 + offset 翻页(全市场 1716 只 ⇒ 约 9 页),把规模/估值/涨跌/换手/成交额/溢折率全拿回来,客户端自己按阈值筛 —— 这是目前唯一能「自定义条件筛 ETF」的路径。
GET /v1/screenGET /v1/screen?filters=pe_ttm%3A0..20%2Croe_ttm%3A%3E%3D15curl "https://api.ashareapi.com/v1/screen?filters=pe_ttm%3A0..20%2Croe_ttm%3A%3E%3D15&key=YOUR_KEY"mode · filters · sort · board · metric · preset · pool · strategy · event · limit · offset · date · start · end · asset · list · slim带 * 为必填快速开始
把下面的代码里的 Key 换成你的(免费端点无需 Key,直接调):
# 注:filters 的值已做 URL 编码(浏览器 / curl 会自动还原,照抄即可)
# 推荐:Authorization 头(密钥不进日志)
curl -H "Authorization: Bearer YOUR_KEY" \
"https://api.ashareapi.com/v1/screen?filters=pe_ttm%3A0..20%2Croe_ttm%3A%3E%3D15"
# 快速测试:直接浏览器打开(?key= 会留在日志/历史里,别用于生产)
curl "https://api.ashareapi.com/v1/screen?filters=pe_ttm%3A0..20%2Croe_ttm%3A%3E%3D15&key=YOUR_KEY"import requests
r = requests.get(
"https://api.ashareapi.com/v1/screen",
headers={"Authorization": "Bearer YOUR_KEY"},
params={},
timeout=30,
)
print(r.json())const r = await fetch("https://api.ashareapi.com/v1/screen?filters=pe_ttm%3A0..20%2Croe_ttm%3A%3E%3D15", {
headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| mode | string | 否 | filter 条件筛选(默认)/ pool 主题池 / rank 排行 / strategy 策略 / event 事件 |
| filters | string | 否 | [filter] 筛选条件,逗号分隔=AND:pe_ttm:0..20,roe_ttm:>=15(区间含两端;可用字段见 list=fields) |
| sort | string | 否 | 排序字段(语义名,见 list=fields);默认降序,- 前缀=升序:sort=roe_ttm / sort=-roe_ttm |
| board | string | 否 | 股票池:hs300 / zz500 / zz1000 / sse50 / sz_component;不传=全市场 |
| metric | string | 否 | [rank] 排行指标:overall 综合 / capital 资金 / fundamental 基本面 / risk 风险 / technical 技术(默认 overall) |
| preset | string | 否 | [filter] 官方预设名(与 filters 二选一):low_pe / high_dividend … 共 22 个,清单见 list=presets |
| pool | string | 否 | [pool] 主题池 / 属性标签:中文名或代码都行(如 央企 / shareholder_central_state);清单见 list=pools |
| strategy | string | 否 | [strategy] 策略:中文名或代码都行(如 高股息 / high_dividend);清单见 list=strategies |
| event | string | 否 | [event] 事件:中文名或代码都行(如 分红预案公告后一月 / dividend_plan);清单见 list=events |
| limit | integer | 否 | 返回条数,默认 20。filter 模式无上限(传 9999 一次取全市场);其余模式单页上限 200 |
| offset | integer | 否 | 跳过前 N 条(翻页)。filter 模式也支持:取全后按 offset:offset+limit 切片,结果只少行、值不变;其余模式直接传数据源 |
| date | string | 否 | 查询日期 YYYY-MM-DD(留空=最新交易日);filter 模式即历史截面选股 |
| start | string | 否 | [pool/strategy] 区间起始日 YYYY-MM-DD(须与 end 同时给) |
| end | string | 否 | [pool/strategy] 区间结束日 YYYY-MM-DD(须与 start 同时给) |
| asset | string | 否 | 资产类别:stock 股票(默认)/ etf|仅 pool/rank 支持 |
| list | string | 否 | 自发现清单:fields 字段 / boards 股票池 / presets 预设 / metrics 排行指标 / pools 主题池 / strategies 策略 / events 事件;true=列出当前模式的全部取值 |
| slim | boolean | 否 | 响应精简:true 时省掉与 structured 完全重复的 tables(单表输出约 −42% 体积);多表输出(calendar / macro)不受影响 |
modestringfiltersstringsortstringboardstringmetricstringpresetstringpoolstringstrategystringeventstringlimitintegeroffsetintegerdatestringstartstringendstringassetstringliststringslimboolean返回字段
下表由线上真实调用采集(非文档推断):每行是响应里的字段名、类型和一条真实样例值,用来对齐解析代码。
structured统一信封: ok / endpoint / tier / elapsed_ms / source / trace_id取样日: 2026-11-09| 字段 | 类型 | 真实样例值 |
|---|---|---|
| code | str | sz000809 |
| name | str | 和展能源 |
| PE_TTM | str | 57192.71 |
| ClosePrice | str | 2.95 |
| ChangePCT | str | -1.01 |
| isST | bool | false |
| isDelisting | bool | false |
| status | str | normal |
返回示例
取样:GET /v1/screen?expr=intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])&limit=3(2026-09-26 线上真实返回,已截断)。⚠️ 注意 data 是 Markdown 表格字符串,不是数组 —— 机器读取请用 structured 或 tables。
{
"ok": true,
"endpoint": "screen",
"tier": "unlimited",
"elapsed_ms": 2430,
"source": "multi",
"data": "| code | name | PE_TTM | ROETTM | ClosePrice | ChangePCT |\n| --- | --- | --- | --- | --- | --- |\n| sz000656 | 金科股份 | 0.35 | 883.0546 | 1.23 | -2.38 |\n| … |",
"structured": [
{ "code": "sz000656", "name": "金科股份", "PE_TTM": "0.35",
"ROETTM": "883.0546", "ClosePrice": "1.23", "ChangePCT": "-2.38" },
{ "code": "sh600841", "name": "动力新科", "PE_TTM": "2.40",
"ROETTM": "50.3702", "ClosePrice": "5.63", "ChangePCT": "-1.57" }
],
"tables": [ [ /* 与 structured 同内容的表格数组 */ ] ]
}统一返回信封: { ok, endpoint, tier, elapsed_ms, source, data }
数据在 data 字段;数据源为空时 ok:false 且不扣次数。
免费端点无需 Key(匿名 5 次/分,解一次 PoW 可到 15 次/分;每次最多 250 根 K 线、每天最多 10 万条)。付费端点按档位限流:体验 30 · 标准 120 · 专业 300 · 机构版 600 次/分;买断档按总量计(不用完不过期)。
看错误码对照表 →常见问题
data 是一个 Markdown 表格字符串?为了让你直接把结果贴给 LLM,data 是 Markdown 表格文本;机器读取请用同级的 structured(对象数组)或 tables(表格数组),三者内容完全一致。
用 intersect([...]) 组合条件,例如 intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])。也可以用 preset 预设(如 LowPE)。limit 默认 20。返回列由你写在 expr 里的因子决定。
/v1/screen 免费吗?有免费的替代吗?不免费(付费端点)。无 Key 调用返回 {"error":"需要 API Key(此端点属付费层)"}。免费替代:/v1/changedist(涨跌分布)、/v1/hot(热搜榜)、/v1/market-overview(市场总览)。
由你的表达式决定 —— 写在 expr 里的因子会直接成为返回列。示例表达式的返回列:code / name / PE_TTM / ROETTM / ClosePrice / ChangePCT。
通用问题(所有端点通用)
免费端点不需要:health、challenge、quote、kline、hot、market-overview、changedist 匿名即可调用。付费端点需要:在请求头带 Authorization: Bearer <你的 Key>。⚠️ 匿名额度按调用者类型分级:浏览器(真人)5 次/分;脚本 / SDK / AI Agent(curl、requests、axios、openai 等 UA)2 次/分 —— 自动化流量更易被滥用。解一次 PoW 挑战(GET /v1/challenge,再带 X-PoW 头)可提到 15 次/分,与类型无关。⚠️ 另外,匿名调用单次最多取 250 根 K 线、每天最多 10 万条 —— 要一次拿满 1212 根或不限日量,请用 API Key。
不会。数据源失败或空结果时返回 ok:false,并自动退回本次计费(total_calls / usage_log / ep_log 三处同时回滚)。只有真正取到数据的请求才计入用量。
行情类(quote / kline / orderbook / changedist)为实时或当日;财务、股东、分红、事件等为数据源披露后 T+1 内。每份响应都自带数据时点字段 —— 分时看 time(HHMM),行情看 date(交易日),据此可核对这份数据对应的是哪一刻。
不能。code 是单值参数,一次一只;批量请并发调用(注意各自档位的每分钟限流)。
配一次 MCP 即可,之后直接问 AI「查一下……」它会自己调。MCP 暴露 92 个工具,覆盖行情 / 财务 / 选股 / 板块 / 宏观。