Infoway API 财务报表接口 （使用教程）

[Fermin Tenney]

Infoway API 正式上线股票财务报表接口，覆盖 A股、美股、港股、印度及日本市场，提供 8 类核心财务数据端点。统一的 API 结构与标准化数据格式，帮助开发者实现分钟级快速接入。所有财报接口无需额外付费，所有套餐均可使用，包括免费套餐。

1. 利润表
查询公司的收入、成本、利润等经营成果数据。是最核心的财报表，反映公司在一段时间内赚了多少钱。

端点：/common/basic/financial/income_statement

​

参数说明:

• symbol: 股票代码，必填项
• type: 股票的上市国家/地区，比如STOCK_CN，STOCK_JP等，必填项
• period_type: fq（季度）/ fy（年度）/ fh（半年），不传则返回全部周期数据

利润表返回示例：

{ "symbol": "000001.SZ", "periodType": "fq", "periodDate": "2025-09-30", "itemId": "net_income", "itemName": "Net income", "itemGroup": "", "itemValue": 10774000000, "ttm": 41524000000, "parentItemId": null }, { "symbol": "000001.SZ", "periodType": "fq", "periodDate": "2025-09-30", "itemId": "oper_income", "itemName": "Operating income", "itemGroup": "", "itemValue": 13167000000, "ttm": 53040000000, "parentItemId": null }

​

返回参数说明：

• periodType: 报告周期：fq=季度、fy=年度、fh=半年
• periodDate: 报告期，如 2025-12-31
• itemId: 科目 ID
• itemName: 科目名称
• itemGroup: 分组
• itemValue: 数值
• ttm: TTM 滚动合计
• parentItemId: 父科目 ID（子科目时非空）

对财务报表的返回参数有疑问的同学，可以看这篇更详细的解释：一文读懂 Infoway 财报 API 字段结构

2. 收入明细
查询收入按业务板块（iPhone / Services / Mac…）或地区（Americas / Greater China…）的拆分明细。主要以年度数据为主。

端点：/common/basic/financial/revenue

收入明细返回示例：

{ "symbol": "AAPL.US", "periodType": "fy", "periodDate": "2025", "itemId": "mac", "itemName": "Mac", "itemGroup": "Revenue by business", "itemValue": 33708000000, "ttm": null }, { "symbol": "AAPL.US", "periodType": "fy", "periodDate": "2025", "itemId": "ipad", "itemName": "iPad", "itemGroup": "Revenue by business", "itemValue": 28023000000, "ttm": null }

​

3. 现金流量表
查询经营 / 投资 / 筹资三大现金流数据，以及自由现金流。现金流比利润更难造假，是判断公司真实盈利能力的重要指标。

端点：/common/basic/financial/cash_flow

现金流量表返回示例：

{ "symbol": "AAPL.US", "periodType": "fq", "periodDate": "2026-03-31", "itemId": "cash_per_share", "itemName": "Cash per share", "itemGroup": "", "itemValue": 4.52, "ttm": null }, { "symbol": "AAPL.US", "periodType": "fq", "periodDate": "2026-03-31", "itemId": "free_cash_flow", "itemName": "Free cash flow", "itemGroup": "", "itemValue": 51552000000, "ttm": 123324000000 }

​

现金流量表接口常见的科目（itemId）

• cf_oper : 经营活动现金流
• cf_invest : 投资活动现金流
• cf_finance : 筹资活动现金流
• cf_free_cash_flow : 自由现金流

4. 资产负债表
查询特定时点的资产、负债、股东权益数据。揭示公司有多少家底、欠了多少钱，是分析偿债能力和资本结构的基础。

端点：/common/basic/financial/balance_sheet

资产负债表返回示例：

{ "symbol": "00005.HK", "periodType": "fq", "periodDate": "2026-03-31", "itemId": "net_debt", "itemName": "Net debt", "itemGroup": "", "itemValue": 1281447803524.06, "ttm": null }, { "symbol": "00005.HK", "periodType": "fq", "periodDate": "2026-03-31", "itemId": "total_debt", "itemName": "Total debt", "itemGroup": "", "itemValue": 3200055461944.65, "ttm": null }

​

• total_assets : 总资产
• total_liabilities : 总负债
• total_equity : 股东权益合计
• cash_and_equiv : 现金及等价物
• total_debt : 总债务

5. 估值与统计指标
查询 PE、PB、ROE、市值等估值与财务比率。与其他端点不同，额外返回 currentValue（当前实时值）和 ttmStr（TTM 字符串），适合做实时估值面板。

端点：/common/basic/financial/statistics

估值与统计指标返回示例：

{ "symbol": "8306.JP", "periodType": "fq", "periodDate": "2025-12-31", "itemId": "net_margin", "itemName": "Net margin %", "itemGroup": "Profitability ratios", "itemValue": 15.86693, "ttmStr": "15.5802279293657", "currentValue": 15.86693 }, { "symbol": "8306.JP", "periodType": "fq", "periodDate": "2025-12-31", "itemId": "price_book", "itemName": "Price to book ratio", "itemGroup": "Valuation ratios", "itemValue": 1.32274, "ttmStr": "-", "currentValue": 1.593341 }

​

注意：ttmStr 是字符串类型，当无数据时为 "-"，不能直接转 float，务必做容错处理。

6. 股息指标
查询每股股息（DPS）、股息率、派息率等指标的历史数据。适合筛选高股息股票或追踪分红趋势。

端点：/common/basic/financial/dividend

股息接口返回示例：

{ "symbol": "00700.HK", "periodType": "fy", "periodDate": "2025-12-31", "itemId": "dividend_payout_ratio", "itemName": "Dividend payout ratio %", "itemGroup": "", "itemValue": 19.822653, "ttmStr": "-", "currentValue": 0 }, { "symbol": "00700.HK", "periodType": "fy", "periodDate": "2025-12-31", "itemId": "dps_common_stock_prim_issue", "itemName": "Dividends per share - common stock primary issue", "itemGroup": "", "itemValue": 4.5, "ttmStr": "-", "currentValue": 0 }

​

7. 历史派息记录
查询每次分红的除权日、登记日、派息日及金额。时间以 Unix 毫秒时间戳返回，是唯一没有 period_type 参数的端点，直接返回全部历史记录。

端点：/common/basic/financial/dividend_payout

历史派息记录返回示例：

{ "symbol": "HDFCBANK.IN", "exDate": 1753444740, "recordDate": 1753444740, "paymentDate": 1754913540, "amount": 2.5, "type": "special" }, { "symbol": "HDFCBANK.IN", "exDate": 1751025540, "recordDate": 1751025540, "paymentDate": 1757246340, "amount": 11, "type": "annual" }

​

派息类型说明：

• quarterly : 季度股息
• interim : 中期股息
• special : 特别股息

8. 业绩预测
查询 EPS 和营收的实际值与市场预期值的对比（Beat / Miss）。返回结构与其他端点不同，没有 itemId，直接输出对比字段，periodKey 格式为 2025-Q1 或 2024。

端点：/common/basic/financial/earnings

返回示例：

{ "symbol": "TSLA.US", "periodType": "fq", "periodKey": "2025-Q4", "epsActual": 0.5, "epsEstimate": 0.4548, "epsPercentage": 9.94, "revenueActual": 24901000000, "revenueEstimate": 24776435200, "revenuePercentage": 0.5 }, { "symbol": "TSLA.US", "periodType": "fq", "periodKey": "2025-Q3", "epsActual": 0.5, "epsEstimate": 0.5582, "epsPercentage": -10.42, "revenueActual": 28095000000, "revenueEstimate": 26540367719, "revenuePercentage": 5.86 }

​