# StableFinance Cash Flow Statements

> StableFinance Cash Flow Statements is a paid API for AI agents from stablefinance.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Retrieves cash flow statement data for public companies by ticker or CIK, supporting annual, quarterly, and TTM periods via pay-per-request x402 micropayments.

## Facts

- Endpoint: GET https://stablefinance.dev/api/financials/cash-flow-statements
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablefinance-cash-flow-statements-5fbd79fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UfiPEDIdoDN-2dU9xRoxl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablefinance-cash-flow-statements-5fbd79fe
```

Example prompt: Pull the annual cash flow statements for Apple (ticker AAPL) for the most recent 5 periods — I want to see free cash flow, capital expenditure, and net cash from operations.

## When to prefer this

Use this endpoint when you need standardized cash flow statement data (operating cash flow, free cash flow, capex) for publicly traded US companies by ticker or CIK. Prefer it over income statement or balance sheet endpoints when the specific question is about cash generation, capital allocation, or liquidity. The pay-per-request x402 model makes it cost-efficient for sporadic or agent-driven queries.

## Known failure modes

- Missing required 'period' parameter returns a validation error
- Unknown ticker or CIK returns an empty cash_flow_statements array
- Invalid date format for report_period fields (not YYYY-MM-DD) causes rejection
- limit exceeds 50 returns a schema validation error
- Payment not processed via x402 results in 402 Payment Required response

## How this service works

Normalized cash flow statements.

## Output

Returns an array of cash flow statement objects, each containing ticker, period type (annual/quarterly/TTM), fiscal period label, report period date, net income, free cash flow, capital expenditure, and net cash flow from operations for the matched company.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 5,
   "period": "annual",
   "ticker": "AAPL"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "period"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "minLength": 1
      },
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1
      },
      "period": {
       "enum": [
        "annual",
        "quarterly",
        "ttm"
       ],
       "type": "string"
      },
      "ticker": {
       "type": "string",
       "minLength": 1
      },
      "report_period": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_gt": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_lt": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_gte": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "report_period_lte": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "cash_flow_statements"
     ],
     "properties": {
      "cash_flow_statements": {
       "type": "array",
       "items": {}
      }
     },
     "additionalProperties": false
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cash_flow_statements": [
   {
    "period": "annual",
    "ticker": "AAPL",
    "net_income": 93736000000,
    "fiscal_period": "FY2024",
    "report_period": "2024-09-28",
    "free_cash_flow": 84289000000,
    "capital_expenditure": 9447000000,
    "net_cash_flow_from_operations": 118254000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablefinance-cash-flow-statements-5fbd79fe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablefinance.dev](https://www.zero.xyz/host/stablefinance.dev/llms.txt)