双十一机构版年付 ¥1,699/年查看年付
付费端点 · 付费

财务报表 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/finance
接口签名
GET /v1/finance?code=sh600667&num=4
一行可跑
curl "https://api.ashareapi.com/v1/finance?code=sh600667&num=4&key=YOUR_KEY"
参数:code * · num带 * 为必填

快速开始

把下面的代码里的 Key 换成你的(免费端点无需 Key,直接调):

curl
# 推荐: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"
Python
import requests

r = requests.get(
    "https://api.ashareapi.com/v1/finance",
    headers={"Authorization": "Bearer YOUR_KEY"},
    params={"code": "sh600667"},
    timeout=30,
)
print(r.json())
JavaScript
const r = await fetch("https://api.ashareapi.com/v1/finance?code=sh600667&num=4", {
  headers: { Authorization: "Bearer YOUR_KEY" },
});
console.log(await r.json());

参数

codestring是
股票代码:sh600667
numinteger
返回期数,默认 4 期(最近 N 期,降序)

返回字段

下表由线上真实调用采集(非文档推断):每行是响应里的字段名、类型和一条真实样例值,用来对齐解析代码。

所在位置: data[][]统一信封: ok / endpoint / tier / elapsed_ms / source取样日: 2026-10-20
字段类型真实样例值
codestrsh600519
EndDatestr2026-06-30
InfoPublDatestr2026-08-15
BasicEPSstr35.57
BasicEPSYOYstr-1.686
CapitalSurplusFundPSstr0.0013
DilutedEPSstr35.57
DilutedEPSYOYstr-1.686
DividendTTMstr65033211845.95
EBITstr61192879672.31
EPSstr35.6112
EPSTTMstr65.1429
EPS_Qstr13.81859
EnterpriseTypestr一般企业
FinancialExpensestr-243237716.96
FinancialExpense_Qstr-127434381.98
GrossIncomeRatiostr89.5552
GrossIncomeRatioTTMstr90.2507
GrossIncomeRatio_Qstr89.4797
GrossProfitTTMstr153563460009.570016
MainIncomePSstr72.5579
MainProfitProportionstr99.9558
NPDeductNonRecurringPLstr44464207646.01
NPPCCGrowRate3Ystr7.3543
NPParentCompanyCutYOYstr-2.0402
NPParentCompanyCutYOY_Qstr-7.09
NPParentCompanyOwnersstr44516880421.86
NPParentCompanyOwnersTTMstr81433985225.44
NPParentCompanyOwners_Qstr17274367535.41
NPParentCompanyYOYstr-1.9516
NPParentCompanyYOY_Qstr-6.9043
NetProfitRatiostr50.7516
NetProfitRatioTTMstr49.5774
ORComGrowRate3Ystr9.2415
OperProfitGrowRatestr-2.163
OperProfitGrowRate_Qstr-7.2208
OperatingCoststr9473762565.88
OperatingCostTTMstr16588549052.86
OperatingCost_Qstr3953033365.56
OperatingExpensestr3206308341.53
OperatingExpense_Qstr1600543576.65
OperatingProfitstr61411291686.27
OperatingProfitTTMstr113451268476.14
OperatingProfit_Qstr23874282999.85
OperatingRevenuestr90703260964.48
OperatingRevenueGrowRatestr1.4699
OperatingRevenueGrowRate_Qstr-5.1417
OperatingRevenuePSTTMstr136.1127
OperatingRevenueTTMstr170152009062.429984
OperatingRevenue_Qstr36794008743.97
RAndDstr114926219.60
RAndD_Qstr55615495.14
ROAstr15.0218
ROATTMstr27.2955
ROEstr17.7179
ROECutstr17.6969
ROECut_Qstr6.855314
ROETTMstr32.4111
ROEWeightedstr16.75
ROE_Qstr6.8753
ROICstr16.3748
RetainedEarningsPSstr199.1347
RoeYOYstr-6.8713
RoeYOY_Qstr-11.5754
SecuCodestrsh600519
SurplusReserveFundPSstr39.3986
TORGrowRatestr1.3001
TORGrowRate_Qstr-5.2336
TotalAdminExpensestr3635355263.82
TotalAdminExpense_Qstr1781591398.01
TotalOperateRevenuePSstr73.8176
TotalOperatingCoststr30946044878.08
TotalOperatingCostTTMstr59917518486.55
TotalOperatingCost_Qstr13753821353.37
TotalOperatingRevenuestr92278072083.21
TotalOperatingRevenueTTMstr173238481420.149984
TotalOperatingRevenue_Qstr37575159697.98
TotalProfeiGrowRatestr-2.1338
TotalProfeiGrowRate_Qstr-7.1908
TotalProfitstr61438419177.29
TotalProfit_Qstr23895169533.27
UndividedProfitstr159.7361
typestrincome
返回

统一返回信封: { ok, endpoint, tier, elapsed_ms, source, data }

数据在 data 字段;数据源为空时 ok:false 且不扣次数。

限流与额度

免费端点无需 Key(匿名 5 次/分,解一次 PoW 可到 15 次/分;每次最多 250 根 K 线、每天最多 10 万条)。付费端点按档位限流:体验 30 · 标准 120 · 专业 300 · 机构版 600 次/分;买断档按总量计(不用完不过期)。

看错误码对照表 →

常见问题

通用问题(所有端点通用)

这些端点需要 API Key 吗?

免费端点不需要: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 是单值参数,一次一只;批量请并发调用(注意各自档位的每分钟限流)。

怎么在 Claude / Cursor / ChatGPT 里直接调用?

配一次 MCP 即可,之后直接问 AI「查一下……」它会自己调。MCP 暴露 92 个工具,覆盖行情 / 财务 / 选股 / 板块 / 宏观。

要把它接进 AI Agent?

配一次 MCP,之后问 AI「查一下……」它自己调。

← 返回完整端点清单