---
title: "批量全字段画像（多只一次取）"
method: GET
path: "/v1/snapshot-batch"
tags: ["pro"]
---

# 批量全字段画像（多只一次取）

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

⭐ **一次拿多只股票的完整画像**（35+ 字段：价格/盘口五档/PE·PB/市值/股本/涨停跌停价/量比/振幅/涨速/外盘内盘），**逐只标明成功与否**。

**它解决什么**：`/v1/snapshot` 只接单只，扫一个池子只能循环（100 只 = 100 次请求 ≈ 30 秒）；本端点一次拿完，实测 **300 只 0.40 秒**（比 `/v1/quote-batch` 快 10 倍）。

**用法**：`codes` 用**逗号分隔**，如 `?codes=sh600519,sz000001,sz300750`；支持裸 6 位码与带前缀。

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

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

⚠️ **仅 A 股**（`sh`/`sz`/`bj`）—— 港股/美股字段布局不同，传了会标 `ok:false` 并提示改用 `/v1/quote`（⛔ 不返回错数据）。

⚠️ **单位**：`volume` 手 · `amount` 万元 · 市值 亿元 · 股本 股 · 比率/涨幅 百分数。

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

## Query parameters

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

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