Parameters
| Name | Type | Req | Description |
|---|---|---|---|
| ticker | path | yes | Ticker symbol. |
| frequency | enum | no | quarterly · yearly. Default quarterly. |
| limit | int | no | Most recent periods. Default 8, max 200. Pass 200 to get the full history available for the ticker. |
Example
curl -H "X-API-Key: rk_YOUR_KEY" \
"https://api.rockmoon.ai/v1/financials/AAPL/cash-flow?frequency=quarterly&limit=2"
r = requests.get(
"https://api.rockmoon.ai/v1/financials/AAPL/cash-flow",
params={"frequency": "quarterly", "limit": 2},
headers={"X-API-Key": "rk_YOUR_KEY"},
)
cf = r.json()["cash_flow"]
print(cf[0]["operating_cash_flow"], cf[0]["free_cash_flow"])
const r = await fetch(
"https://api.rockmoon.ai/v1/financials/AAPL/cash-flow?frequency=quarterly&limit=2",
{ headers: { "X-API-Key": "rk_YOUR_KEY" } },
);
const { cash_flow } = await r.json();
Response 200
{
"ticker": "AAPL",
"market": "US",
"accounting_standard": "USGAAP",
"cash_flow": [
{ "period": "2025Q4",
"report_date": "2025-12-27",
"operating_cash_flow": 53925000000,
"depreciation": 3214000000,
"deferred_income_tax": null,
"stock_based_compensation": 3594000000,
"change_in_working_capital": 23995000000,
"investing_cash_flow": -4886000000,
"capital_expenditure": 2373000000,
"acquisitions_net": null,
"purchases_of_investments": 12693000000,
"sales_maturities_of_investments": 10334000000,
"financing_cash_flow": -39656000000,
"common_stock_issuance": null,
"share_buyback": 24701000000,
"common_dividends_paid": 3921000000,
"preferred_dividends_paid": null,
"dividends_paid": 3921000000,
"short_term_net_debt_issuance": -5910000000,
"long_term_net_debt_issuance": null,
"net_debt_issuance": -5910000000,
"interest_paid": null,
"income_taxes_paid": 3434000000,
"effect_of_exchange_rate_changes": null,
"change_in_cash": 9383000000,
"begin_period_cash_flow": null,
"end_period_cash_flow": null,
"free_cash_flow": 51552000000 }
],
"trace_id": "3a62d77e8f15445885482f4cd16f33bc"
}
Errors
| HTTP | Code | Cause |
|---|---|---|
| 404 | ticker_not_found | Unknown ticker. |
| 429 | rate_limit_exceeded | Rate limit hit. Honor Retry-After. |
Notes
- Free cash flow is derived as
operating_cash_flow - capital_expenditure. Components are all returned so you can rederive client-side if you prefer a stricter definition. - Sign convention:
capital_expenditure,share_buyback,dividends_paidare reported as positive magnitudes.investing_cash_flowandfinancing_cash_floware signed net flows. - Null fields mean the filer didn't disclose that line in the period — not zero.