Financials
Cash flow statement
- Coverage
- US / CN / JP, the last 3 years
- Billing
- 20 cr / thousand calls
Returns a company's cash flow statement: operating, investing and financing cash flows plus free cash flow, one row per reporting period. 16 line-item columns in total, plus the 14 meta-data fields shared by the three statements, all listed under Response fields. Signs follow the statement direction: outflows such as capital expenditures, buybacks and dividends are negative, inflows such as investment proceeds are positive. free_cash_flow is a derived column (not an as-reported line). Quarterly cash flows may be calculated from cumulative disclosures; half-year or full-year cumulative amounts are not returned as single-quarter amounts.
The example shows the complete key set; a line item that is missing or cannot be calculated reliably appears as null in the actual response.
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| ticker | string | required | Up to 10 tickers, comma-separated. |
| period | stringenum | optional | FY (full fiscal year, excluding TTM), Q1, Q2, Q3, Q4 (the four quarters of the company’s fiscal year); multiple values allowed, comma-separated. Only periods with data are returned; no matching data returns an empty array. Default: FY. |
| limit | int | optional | Number of periods per ticker, counting back from the most recent period; maximum 40. Default: 4. |
Response fields
| Field | Type | Description |
|---|---|---|
| ticker | string | Canonical ticker (US has no suffix, e.g. AAPL; CN is 600519.SH; JP is 7203.T) |
| market | stringenum | Market code: US / CN / JP |
| fiscal_year | int | Fiscal year |
| period | stringenum | FY / Q1 / Q2 / Q3 / Q4 |
| period_start | date | Period start date; null for /balance-sheets |
| report_period | date | Period end date |
| currency | string | Reporting currency |
| accounting_standard | stringenum | US-GAAP / IFRS / CN-GAAP / JP-GAAP |
| accession_number | string | Native document number from the official source: US is the SEC accession (e.g. 0000320193-25-000123), JP the EDINET docID, CN the cninfo announcement id |
| form_type | string | Type of the source filing, in the market's native encoding (US: SEC form names such as 10-K / 10-Q; JP: EDINET numeric codes; CN: annual_report and the like) |
| filing_url | string | Deep link to the official filing; opens the source document directly |
| filing_date | date | Filing date: the date the document became public on the official channel |
| derived_fields | string[] | Names of fields calculated from other periods or line items, or normalized for sign; [] when none |
| derivation | object | Calculation trees keyed by the names in derived_fields; {} when none. Each step includes operation, metric, value, currency, period_start, report_period, and available_at; calculated nodes list recursive inputs in operation order, while reported leaves include the four official provenance fields; cross-report calculations also include basis (the basis report’s four official provenance fields and available_at) |
| operating_cash_flow | number | Net cash flow from operating activities |
| change_in_working_capital | number | Change in working capital |
| capital_expenditures | number | Capital expenditures (negative) |
| acquisitions_net | number | Net cash for acquisitions; outflows are negative. Positive when the cash acquired exceeds the consideration paid; the sign follows the filer's disclosure |
| purchases_of_investments | number | Cash paid for investments (negative) |
| proceeds_from_investments | number | Cash received from disposal of investments (positive) |
| investing_cash_flow | number | Net cash flow from investing activities |
| share_repurchases | number | Cash paid for share repurchases (negative) |
| dividends_paid | number | Dividends paid (negative, including those paid to noncontrolling interests). The CN statutory line "Cash paid for distribution of dividends or profits, or for interest payments" includes interest, and is returned exactly as filed, not split out |
| financing_cash_flow | number | Net cash flow from financing activities |
| effect_of_exchange_rate_on_cash | number | Effect of exchange rate changes on cash |
| net_change_in_cash | number | Net change in cash |
| cash_at_end_of_period | number | Cash at end of period |
| income_taxes_paid | number | Supplemental disclosure: income taxes paid (negative) |
| interest_paid | number | Supplemental disclosure: interest paid (negative) |
| free_cash_flow | number | Derived (not an as-reported line) = operating_cash_flow + capital_expenditures |
No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.
Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.