---
title: "批量股东研究（多只一次取）"
method: GET
path: "/v1/shareholder-batch"
tags: ["pro"]
---

# 批量股东研究（多只一次取）

`GET /v1/shareholder-batch`

## 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

⭐ **一次拿多只的股东研究**（十大股东 / 十大流通股东 / 股东户数统计），**逐只标明成功与否** —— 给量化选股后的批量『谁在持有、股权集中度如何』用。

**它解决什么**：`/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）及以上**，标准版不可用。

## Query parameters

- `codes` string, required: 多个股票代码，逗号分隔：sh600519,hk00700（专业版 ≤200 只 · 不限量版 ≤300 只）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)