财务报表 API
财务报表三件套:利润表 / 资产负债表 / 现金流量表(多期,最近 N 期)。用户问『营收/净利润/毛利率/负债/财务数据』时用。 ⭐ 多只请用 /v1/finance-batch(一次 10 只、逐只标明成功与否,实测 10 只 × 4 期 4.2 秒)—— 循环 20 只要 20 次请求。本端点只查一只。 ⚠️ data 是【表列表】:data[0]=利润表 · data[1]=资产负债表 · data[2]=现金流量表;每张表是 [{EndDate: …, 字段: …}],期次降序(最新一期在最前)。 ⚠️ 2026-09-25 修正:此前返回的是最早 N 期(可能不含最新披露期)—— 已改为最近 N 期。⚠️ 支持港股(代码形如 hk00700;实测返回 6 行)—— 港股的报表期次/字段口径以返回为准,⛔ 别按 A 股列名硬解析。 ⚠️⚠️ 银行 / 保险 / 券商没有 TotalAssets(金融业走专用报表口径):该键不存在,也没有流动/非流动拆分(这两项对银行本身不适用)。用 EnterpriseType 判行业(如 商业银行)。银行请按下面口径取,⛔ 别用 TotalCurrentAssets + TotalNonCurrentAssets 推总资产(两者对银行都缺): · 总资产 = TotalLiability + TotalShareholderEquity · 净资产 = SEWithoutMI(归母)/ TotalShareholderEquity(含少数股东) · 资产负债率 = 直接用 DebtAssetsRatio(⛔ 别自算) · 总资产增速 = 直接用 TotalAssetGrowRate 实测印证(sh601398 工商银行 2026-06-30):TotalLiability 52,714,748,999,999.99 + TotalShareholderEquity 4,355,844,000,000 = 57,070,592,999,999.99,与 DebtAssetsRatio 92.3676% 逐位吻合 ⇒ 资产负债表本身是完整的,只是没有「通用总资产」这个字段。
GET /v1/financeGET /v1/finance?code=sh600667&num=4curl "https://api.ashareapi.com/v1/finance?code=sh600667&num=4&key=YOUR_KEY"code * · num带 * 为必填快速开始
把下面的代码里的 Key 换成你的(免费端点无需 Key,直接调):
# 推荐:Authorization 头(密钥不进日志)
curl -H "Authorization: Bearer YOUR_KEY" \
"https://api.ashareapi.com/v1/finance?code=sh600667&num=4"
# 快速测试:直接浏览器打开(?key= 会留在日志/历史里,别用于生产)
curl "https://api.ashareapi.com/v1/finance?code=sh600667&num=4&key=YOUR_KEY"import requests
r = requests.get(
"https://api.ashareapi.com/v1/finance",
headers={"Authorization": "Bearer YOUR_KEY"},
params={"code": "sh600667"},
timeout=30,
)
print(r.json())const r = await fetch("https://api.ashareapi.com/v1/finance?code=sh600667&num=4", {
headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | string | 是 | 股票代码:sh600667 |
| num | integer | 否 | 返回期数,默认 4 期(最近 N 期,降序) |
codestring是numinteger返回字段
下表由线上真实调用采集(非文档推断):每行是响应里的字段名、类型和一条真实样例值,用来对齐解析代码。
data[][]统一信封: ok / endpoint / tier / elapsed_ms / source取样日: 2026-10-20| 字段 | 类型 | 真实样例值 |
|---|---|---|
| code | str | sh600519 |
| EndDate | str | 2026-06-30 |
| InfoPublDate | str | 2026-08-15 |
| BasicEPS | str | 35.57 |
| BasicEPSYOY | str | -1.686 |
| CapitalSurplusFundPS | str | 0.0013 |
| DilutedEPS | str | 35.57 |
| DilutedEPSYOY | str | -1.686 |
| DividendTTM | str | 65033211845.95 |
| EBIT | str | 61192879672.31 |
| EPS | str | 35.6112 |
| EPSTTM | str | 65.1429 |
| EPS_Q | str | 13.81859 |
| EnterpriseType | str | 一般企业 |
| FinancialExpense | str | -243237716.96 |
| FinancialExpense_Q | str | -127434381.98 |
| GrossIncomeRatio | str | 89.5552 |
| GrossIncomeRatioTTM | str | 90.2507 |
| GrossIncomeRatio_Q | str | 89.4797 |
| GrossProfitTTM | str | 153563460009.570016 |
| MainIncomePS | str | 72.5579 |
| MainProfitProportion | str | 99.9558 |
| NPDeductNonRecurringPL | str | 44464207646.01 |
| NPPCCGrowRate3Y | str | 7.3543 |
| NPParentCompanyCutYOY | str | -2.0402 |
| NPParentCompanyCutYOY_Q | str | -7.09 |
| NPParentCompanyOwners | str | 44516880421.86 |
| NPParentCompanyOwnersTTM | str | 81433985225.44 |
| NPParentCompanyOwners_Q | str | 17274367535.41 |
| NPParentCompanyYOY | str | -1.9516 |
| NPParentCompanyYOY_Q | str | -6.9043 |
| NetProfitRatio | str | 50.7516 |
| NetProfitRatioTTM | str | 49.5774 |
| ORComGrowRate3Y | str | 9.2415 |
| OperProfitGrowRate | str | -2.163 |
| OperProfitGrowRate_Q | str | -7.2208 |
| OperatingCost | str | 9473762565.88 |
| OperatingCostTTM | str | 16588549052.86 |
| OperatingCost_Q | str | 3953033365.56 |
| OperatingExpense | str | 3206308341.53 |
| OperatingExpense_Q | str | 1600543576.65 |
| OperatingProfit | str | 61411291686.27 |
| OperatingProfitTTM | str | 113451268476.14 |
| OperatingProfit_Q | str | 23874282999.85 |
| OperatingRevenue | str | 90703260964.48 |
| OperatingRevenueGrowRate | str | 1.4699 |
| OperatingRevenueGrowRate_Q | str | -5.1417 |
| OperatingRevenuePSTTM | str | 136.1127 |
| OperatingRevenueTTM | str | 170152009062.429984 |
| OperatingRevenue_Q | str | 36794008743.97 |
| RAndD | str | 114926219.60 |
| RAndD_Q | str | 55615495.14 |
| ROA | str | 15.0218 |
| ROATTM | str | 27.2955 |
| ROE | str | 17.7179 |
| ROECut | str | 17.6969 |
| ROECut_Q | str | 6.855314 |
| ROETTM | str | 32.4111 |
| ROEWeighted | str | 16.75 |
| ROE_Q | str | 6.8753 |
| ROIC | str | 16.3748 |
| RetainedEarningsPS | str | 199.1347 |
| RoeYOY | str | -6.8713 |
| RoeYOY_Q | str | -11.5754 |
| SecuCode | str | sh600519 |
| SurplusReserveFundPS | str | 39.3986 |
| TORGrowRate | str | 1.3001 |
| TORGrowRate_Q | str | -5.2336 |
| TotalAdminExpense | str | 3635355263.82 |
| TotalAdminExpense_Q | str | 1781591398.01 |
| TotalOperateRevenuePS | str | 73.8176 |
| TotalOperatingCost | str | 30946044878.08 |
| TotalOperatingCostTTM | str | 59917518486.55 |
| TotalOperatingCost_Q | str | 13753821353.37 |
| TotalOperatingRevenue | str | 92278072083.21 |
| TotalOperatingRevenueTTM | str | 173238481420.149984 |
| TotalOperatingRevenue_Q | str | 37575159697.98 |
| TotalProfeiGrowRate | str | -2.1338 |
| TotalProfeiGrowRate_Q | str | -7.1908 |
| TotalProfit | str | 61438419177.29 |
| TotalProfit_Q | str | 23895169533.27 |
| UndividedProfit | str | 159.7361 |
| type | str | income |
统一返回信封: { ok, endpoint, tier, elapsed_ms, source, data }
数据在 data 字段;数据源为空时 ok:false 且不扣次数。
免费端点无需 Key(匿名 5 次/分,解一次 PoW 可到 15 次/分;每次最多 250 根 K 线、每天最多 10 万条)。付费端点按档位限流:体验 30 · 标准 120 · 专业 300 · 机构版 600 次/分;买断档按总量计(不用完不过期)。
看错误码对照表 →常见问题
通用问题(所有端点通用)
免费端点不需要:health、challenge、quote、kline、hot、market-overview、changedist 匿名即可调用。付费端点需要:在请求头带 Authorization: Bearer <你的 Key>。⚠️ 匿名额度按调用者类型分级:浏览器(真人)5 次/分;脚本 / SDK / AI Agent(curl、requests、axios、openai 等 UA)2 次/分 —— 自动化流量更易被滥用。解一次 PoW 挑战(GET /v1/challenge,再带 X-PoW 头)可提到 15 次/分,与类型无关。⚠️ 另外,匿名调用单次最多取 250 根 K 线、每天最多 10 万条 —— 要一次拿满 1212 根或不限日量,请用 API Key。
不会。数据源失败或空结果时返回 ok:false,并自动退回本次计费(total_calls / usage_log / ep_log 三处同时回滚)。只有真正取到数据的请求才计入用量。
行情类(quote / kline / orderbook / changedist)为实时或当日;财务、股东、分红、事件等为数据源披露后 T+1 内。每份响应都自带数据时点字段 —— 分时看 time(HHMM),行情看 date(交易日),据此可核对这份数据对应的是哪一刻。
不能。code 是单值参数,一次一只;批量请并发调用(注意各自档位的每分钟限流)。
配一次 MCP 即可,之后直接问 AI「查一下……」它会自己调。MCP 暴露 92 个工具,覆盖行情 / 财务 / 选股 / 板块 / 宏观。