Batch chip distribution (profit ratio / average cost / concentration, many stocks in one call) API
⭐ Fetch chip distribution for many stocks in one call (profit ratio / average cost / 90% and 70% concentration), with per-symbol status. What it solves: /v1/chip takes one symbol at a time, so scanning 200 symbols means 200 calls; this endpoint returns them in 3.9 seconds (measured, 200 symbols). Why not just use /v1/chip: its code accepts commas too, but the response is a wide N x 8N diagonal matrix (row i only carries group i, every other cell is -), which is impossible to line up in pandas - and the whole column group of an invalid symbol disappears, so you cannot tell which one is missing. This endpoint fills in every requested symbol and says why any are missing. Response: data is an array; each item has code / ok / data:[...] or error; plus requested / returned / failed. Limits: Pro up to 200 symbols, Unlimited up to 300. Billing is per symbol actually returned. ⚠️ date applies to all symbols at once; on non-trading days the upstream falls back to the most recent trading day - trust the date in each row. ⚠️ A-shares only (sh/sz/bj) - HK / US symbols are flagged as failed with a pointer to /v1/chip. ⚠️ History is kept for roughly the last year only. ⚠️ Paid endpoint: Pro (¥99) and above.
GET /v1/chip-batchGET /v1/chip-batch?codes=&date=2026-09-16curl "https://api.ashareapi.com/v1/chip-batch?codes=&date=2026-09-16&key=YOUR_KEY"codes * · date* = requiredQuick start
Replace the key below with yours (free endpoints need no key):
# 推荐：Authorization 头（密钥不进日志）
curl -H "Authorization: Bearer YOUR_KEY" \
"https://api.ashareapi.com/v1/chip-batch?codes=&date=2026-09-16"
# 快速测试：直接浏览器打开（?key= 会留在日志/历史里，别用于生产）
curl "https://api.ashareapi.com/v1/chip-batch?codes=&date=2026-09-16&key=YOUR_KEY"import requests
r = requests.get(
"https://api.ashareapi.com/v1/chip-batch",
headers={"Authorization": "Bearer YOUR_KEY"},
params={"codes": ""},
timeout=30,
)
print(r.json())const r = await fetch("https://api.ashareapi.com/v1/chip-batch?codes=&date=2026-09-16", {
headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| codes | string | Yes | 多个股票代码，逗号分隔：sh600519,sz000001（专业版 ≤200 只 · 不限量版 ≤300 只） |
| date | string | No | Date YYYY-MM-DD (blank = latest trading day) |
codesstringYesdatestringUnified envelope: { ok, endpoint, tier, elapsed_ms, source, data }
Rows live in data; when upstream returns nothing you get ok:false and the call is not counted.
Free endpoints need no key (anonymous 5/min — 250 bars per request, 100k rows per day; solve one PoW challenge for 15/min). Paid tiers: Trial 30 · Standard 120 · Pro 300 · Unlimited 600 per minute; buyout packs are capped by total calls and never expire.
See the error code table →FAQ
General (applies to every endpoint)
Free endpoints do not: health, challenge, quote, kline, hot, market-overview and changedist work anonymously. Paid endpoints do: send Authorization: Bearer <your key>. ⚠️ The anonymous allowance is tiered by caller type: browsers (humans) get 5/min; scripts, SDKs and AI Agents (curl, requests, axios, openai user-agent strings) get 2/min — automated traffic is easier to abuse. Solving one PoW challenge (GET /v1/challenge, then send the X-PoW header) raises it to 15/min regardless of type. ⚠️ Also, anonymous calls are capped at 250 bars per request and 100k rows per day — use an API key for the full 1212 bars or unlimited daily volume.
No. When the upstream fails or returns nothing you get ok:false and the charge for that call is refunded (total_calls / usage_log / ep_log are rolled back together). Only calls that actually returned data count.
Quotes (quote / kline / orderbook / changedist) are real-time or current session; financials, shareholders, dividends and events are within T+1 of upstream disclosure. The source field in every response tells you which data channel actually served it.
No. code is a single-value parameter — one stock per call. For batches, issue concurrent calls and respect your tier per-minute limit.
Set up MCP once, then just ask the AI — it calls the endpoint itself. MCP exposes 39 tools covering quotes, financials, screening, sectors and macro.
Related endpoints
Set up MCP once, then just ask the AI — it calls the endpoint itself.