批量股东研究(多只一次取)
⭐ 一次拿多只的股东研究(十大股东 / 十大流通股东 / 股东户数统计),逐只标明成功与否 —— 给量化选股后的批量『谁在持有、股权集中度如何』用。
它解决什么:/v1/shareholder 一次只能问一只,筛出 200 只后要循环 200 次(≈ 3 分钟,还会撞限频退避);本端点实测 200 只 4.1 秒、300 只 5.6 秒拿完,且缺了哪只一眼可见。
用法:codes 用逗号分隔,如 ?codes=sh600519,sz000001,sz000750;支持裸 6 位码(600519)与带前缀(sh600519);港股的 hk00700 也可以混在一起传。
返回:data 是数组,每项 {code, ok, data}(或 error)—— 取几只就回几个条目;data 内结构与 /v1/shareholder 完全一致(market + tables[{title,slug,rows}] + data{slug: rows}),从单只切到批量不用改解析代码;同时给 requested / returned / failed 计数。
⚠️ 与 /v1/shareholder 的区别:/v1/shareholder 的 code 虽也支持逗号,但返回是一大坨 markdown、没有逐只状态,无效代码会静默消失(少了哪只你算不出来);本端点逐只回填,缺谁、为什么缺都写清楚。
上限:专业版单次最多 200 只,不限量版 300 只。计费按实际返回只数(失败的不计)。
⚠️ 支持沪深 A 股 + 港股(与上游帮助一致)。北交所/ETF/指数/美股在批量里拿不到数据,传了会标 ok:false 并提示改用 /v1/shareholder 单只查询(⛔ 不返回错数据)。
⚠️ A 股与港股段语义不同(都 3 段但完全不同):A 股 = 十大股东 / 十大流通股东 / 股东户数统计;港股 = 持股股东信息 / 股东分布 / 机构持仓统计 ⇒ 按返回里的 market 和 slug 取,⛔ 别按序号。
⚠️ 付费端点:专业版(¥99)及以上,标准版不可用。
Request
- Base URL: https://api.ashareapi.com (the document declares no server; this is the origin it was published from)
- URL: https://api.ashareapi.com/v1/shareholder-batch
- Auth: none declared
Query parameters
多个股票代码,逗号分隔:sh600519,hk00700(专业版 ≤200 只 · 不限量版 ≤300 只)
Response
Successful Response
Changes
No recorded changes to this operation across all 2 revisions of this API.