Infoway API has officially launched its Financial Statements API, covering the China A-share, U.S., Hong Kong, India, and Japan markets with 8 core financial data endpoints. A unified API structure and standardized data format allow developers to integrate within minutes.
1. Income Statement
Retrieve a company’s revenue, expenses, and profit data. This is the most important financial statement, showing how much money a company earned over a specific period.
Endpoint: /common/basic/financial/income_statement
Response Example
{
"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
}
2. Revenue Breakdown
Retrieve revenue segmented by business line (such as iPhone, Services, Mac) or by region (such as Americas or Greater China). Data is primarily provided on an annual basis.
Endpoint: /common/basic/financial/revenue
Response Example
{
"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. Cash Flow Statement
Retrieve operating, investing, and financing cash flow data, along with free cash flow. Cash flow is generally harder to manipulate than profit figures, making it a key indicator of a company’s true profitability.
Endpoint: /common/basic/financial/cash_flow
Response Example
{
"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
}
Common Cash Flow Statement itemIds:
-
cf_oper: Operating Cash Flow -
cf_invest: Investing Cash Flow -
cf_finance: Financing Cash Flow -
cf_free_cash_flow: Free Cash Flow ## 4. Balance Sheet Retrieve assets, liabilities, and shareholders’ equity data for a specific point in time. This statement reveals what a company owns and owes, forming the foundation for analyzing solvency and capital structure.
Endpoint: /common/basic/financial/balance_sheet
Response Example
{
"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
}
5. Valuation & Financial Metrics
Retrieve valuation and financial ratios such as PE, PB, ROE, and market capitalization. Unlike other endpoints, this endpoint additionally returns currentValue (real-time value) and ttmStr (TTM string), making it ideal for building real-time valuation dashboards.
Endpoint: /common/basic/financial/statistics
Response Example
{
"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
}
Note:
ttmStr is returned as a string. When no data is available, its value will be "-", so it should not be directly converted to a float. Proper error handling is strongly recommended.
6. Dividend Metrics
Retrieve historical data for dividend-related metrics such as DPS (Dividend Per Share), dividend yield, and payout ratio. Ideal for screening high-dividend stocks or tracking dividend trends.
Endpoint: /common/basic/financial/dividend
Response Example
{
"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. Historical Dividend Records
Retrieve historical dividend events, including ex-dividend dates, record dates, payment dates, and dividend amounts. Time values are returned as Unix millisecond timestamps. This is the only endpoint that does not include a period_type parameter and always returns the full historical record.
Endpoint: /common/basic/financial/dividend_payout
Response Example
{
"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"
}
Dividend type definitions:
quarterly : Quarterly Dividend
interim : Interim Dividend
special : Special Dividend
8. Earnings Estimates
Retrieve comparisons between actual and expected EPS and revenue results (Beat / Miss). Unlike other endpoints, the response structure does not include itemId. Instead, comparison fields are returned directly. The periodKey format is 2025-Q1 or 2024.
Endpoint: /common/basic/financial/earnings
Response Example
{
"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
}
9. Use Cases
The financial data provided by Infoway API is highly comprehensive and can be used in a wide range of real-world applications, including:
1. Net Profit Growth Tracker
Pull income statement data for the past 8 quarters, calculate YoY and QoQ growth rates, and generate line charts in the terminal or Jupyter Notebook to visually identify whether a company’s earnings momentum is accelerating.
2. Apple Business Segment Visualization
Use the Revenue Breakdown endpoint to retrieve 5 years of iPhone, Services, Mac, and Wearables revenue data, then build an area chart to clearly visualize the growing contribution of Apple’s services business.
3. Value Stock Screening Script
Batch query PE, PB, and ROE metrics for a basket of stocks, then automatically filter candidates matching conditions such as PE < 15, ROE > 15%, and debt-to-asset ratio < 60%, with results exported to CSV.
4. High-Dividend Portfolio Monitoring
Regularly query dividend_yield and payout_ratio for portfolio holdings, and trigger alerts when dividend yield drops abnormally or payout ratio exceeds 90%, helping investors avoid dividend traps.
5. Earnings Calendar & Surprise Alerts
Query the earnings endpoint to retrieve market consensus estimates before earnings releases, then compare actual results immediately after publication, calculate EPS beat/miss percentages, and push notifications to Telegram or WeCom.
6. Free Cash Flow Health Scoring
Combine cash flow statement and income statement data to calculate metrics such as FCF Margin and the operating cash flow-to-net income ratio, helping quickly identify companies with potentially inflated “paper profits.”
Top comments (0)