pro

批量财务报表(多只一次取)

⭐ 一次拿多只的三大报表(利润表 / 资产负债表 / 现金流量表),逐只标明成功与否 —— 给量化选股后的批量财务筛选(营收/净利/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)及以上,标准版不可用。

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

Query parameters

codesstring required

多个股票代码,逗号分隔:sh600519,sz000001(专业版 ≤20 只 · 不限量版 ≤30 只)

periodsinteger

每只返回期数(默认 4,最多 12,降序最新在前)

typestring

只取一张表:income / balance / cashflow(省略=三张全取)

fieldsstring

字段范围:all(默认,186 列)/ core(69 列,载荷约 1/3)

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.