---
title: "批量筹码分布（多只一次取）"
method: GET
path: "/v1/chip-batch"
tags: ["pro"]
---

# 批量筹码分布（多只一次取）

`GET /v1/chip-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/chip-batch`
- Auth: none declared

⭐ **一次拿多只股票的筹码分布与持仓成本**（获利盘比例 / 平均成本 / 90% 与 70% 集中度），**逐只标明成功与否** —— 给量化筛股后判断抛压用。

**它解决什么**：`/v1/chip` 一次只能问一只，筛出 200 只就要循环 200 次；本端点实测 **200 只 3.9 秒**拿完（300 只 5.8 秒）。

**用法**：`codes` 用**逗号分隔**，如 `?codes=sh600519,sz000001,sz300750`；支持裸 6 位码（`600519`）与带前缀（`sh600519`）。`date` 对**所有代码同时生效**。

**返回**：`data` 是数组，每项 `{code, ok, data}`（或 `error`）—— **取几只就回几个条目**；同时给 `requested` / `returned` / `failed` 计数。

⚠️ **与 `/v1/chip` 的区别**：`/v1/chip` 的 `code` 虽也支持逗号，但返回是**横向并排的 N×8N 对角矩阵**（第 i 行只有第 i 组有值、其余全是 `-`），拿 pandas 一行都拼不出来；而且**无效代码的整组列会直接消失**，少了哪只算不出来。本端点逐只回填，缺谁、为什么缺都写清楚。

**上限**：专业版单次最多 **200** 只，不限量版 **300** 只。**计费按实际返回只数**（失败的不计）。

⚠️ **仅沪深 A 股**（`sh`/`sz`/`bj`）—— 港股/美股/板块传了会标 `ok:false` 并提示改用 `/v1/chip` 单只查询（⛔ 不返回错数据）。

⚠️ **历史仅保留约近 1 年**；非交易日/未来日期会自动回退到最近交易日，**以返回行里的 `date` 为准**。

⚠️ **付费端点**：**专业版（¥99）及以上**，标准版不可用。

## Query parameters

- `codes` string, required: 多个股票代码，逗号分隔：sh600519,sz000001（专业版 ≤200 只 · 不限量版 ≤300 只）
- `date` string: 交易日 YYYY-MM-DD（默认最新，对所有代码生效）

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