---
title: "批量财务报表（多只一次取）"
method: GET
path: "/v1/finance-batch"
tags: ["pro"]
---

# 批量财务报表（多只一次取）

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

⭐ **一次拿多只的三大报表**（利润表 / 资产负债表 / 现金流量表），**逐只标明成功与否** —— 给量化选股后的批量财务筛选（营收/净利/ROE/负债率/现金流）用。

**它解决什么**：`/v1/finance` 一次只能问一只，筛出 10 只后要循环 10 次；本端点一次拿完，实测 **10 只 × 4 期 4.2 秒**，且**缺了哪只一眼可见**。

**用法**：`codes` 用**逗号分隔**，如 `?codes=sh600519,sz000001`；支持裸 6 位码。`periods` 是每只取几期（默认 4，最多 12，降序最新在前）；`type` 可只取一张表（`income` / `balance` / `cashflow`，省略则三张全取）；`fields` 取 `all`（默认，186 列）或 `core`（69 列，载荷约 1/3）。

**返回**：`data` 是数组，每项 `{code, ok, data}`（或 `error`）—— **取几只就回几个条目**；`data` 内是 `market` + `tables[{title,slug,rows}]` + `data{slug: rows}`，slug 为 `income` / `balance` / `cashflow`；同时给 `requested` / `returned` / `failed` 计数。

⚠️ **与 `/v1/finance` 的区别**：`/v1/finance` 的 `code` 虽也支持逗号，但返回是**扁平的 3 张表**，哪只没回来、为什么没回来**完全看不出来**；本端点**逐只回填**，缺谁、为什么缺都写清楚。

**上限**：专业版单次最多 **10** 只，不限量版 **20** 只；并且 **只数 × 期数 不得超过 40**（如 10 只 × 4 期 = 40 ✅、20 只 × 2 期 = 40 ✅、20 只 × 4 期 = 80 ❌）。**计费按实际返回只数**（失败的不计）。

⚠️ **这个上限比其它批量端点小得多**：财报数据的上游配额是按「只 × 期」消耗的 —— 实测 10 只×4 期 三次全中、20 只×2 期 全中；但 20 只×4 期 只回 5 只、30 只×4 期 只回 3 只、40 只×1 期 只回 10 只、50 只直接限频。需要更大规模请分批。命中限频时本端点会逐只标失败并**自动退还次数**。

⚠️ **仅 A 股**（`sh`/`sz`/`bj`）—— 港股/美股在批量里未验证，传了会标 `ok:false` 并提示改用 `/v1/finance` 单只查询（⛔ 不返回错数据）。

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

## Query parameters

- `codes` string, required: 多个股票代码，逗号分隔：sh600519,sz000001（专业版 ≤20 只 · 不限量版 ≤30 只）
- `periods` integer: 每只返回期数（默认 4，最多 12，降序最新在前）
- `type` string: 只取一张表：income / balance / cashflow（省略=三张全取）
- `fields` string: 字段范围：all（默认，186 列）/ core（69 列，载荷约 1/3）

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