# Falcon Financial Statements API

> Falcon Financial Statements API is a paid API for AI agents from falcon-comps.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns up to 15 fiscal years plus TTM of income statement, balance sheet, and cash flow data for a US public company, along with key ratios and SEC XBRL tags, given a ticker or CIK.

## Facts

- Endpoint: POST https://falcon-comps.vercel.app/v1/financials?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/falcon-financial-statements-api-64e0f1f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OVtptcNESmXBbvBL0L9SC

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 falcon-financial-statements-api-64e0f1f4 -d '<json body>'
```

Example prompt: Pull the full financial statement history for Apple — income statement, balance sheet, and cash flow — including the latest TTM figures and key ratios like gross margin, so I can model the business without digging through 10-Ks.

## When to prefer this

Use this endpoint when you need clean, structured, multi-year financial statements (income statement, balance sheet, cash flow) for a US public company without manually scraping SEC 10-K filings. It is ideal for financial modeling, equity research, credit analysis, or any workflow requiring XBRL-tagged historical data and TTM figures in a single call. Prefer it over raw SEC EDGAR access when you want pre-parsed, ratio-enriched data with a consistent schema.

## Known failure modes

- Unknown or invalid ticker returns 404 before payment is charged
- CIK not found in SEC database returns 404
- Company has insufficient XBRL filing history, resulting in fewer than expected fiscal years
- Rate limit or payment failure returns an error before data is returned
- Non-US companies not covered by SEC XBRL system return an error

## How this service works

falcon.sol: Use this when you need clean, comparable financial statements for a US public company without scraping 10-Ks. Send a ticker or CIK; get up to 15 fiscal years plus TTM of income statement, balance sheet and cash flow, key ratios, and the SEC XBRL tag behind every number. Unknown tickers return 404 before payment; free preview at /v1/preview. $0.015 USDC.

## Output

A JSON object containing: the ticker/CIK, an array of fiscal year end dates, income statement arrays (revenue, net income, etc.), balance sheet arrays, cash flow arrays, key ratios (e.g. gross margin), TTM figures as of the most recent date, and the SEC XBRL tag behind each data point — covering up to 15 fiscal years.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ttm": {
   "as_of": "2026-06-27",
   "revenue": 466823000000
  },
  "ratios": {
   "gross_margin": 0.4691
  },
  "ticker": "AAPL",
  "fiscal_years": [
   "2024-09-28",
   "2025-09-27"
  ],
  "income_statement": {
   "revenue": [
    391035000000,
    416161000000
   ],
   "net_income": [
    93736000000,
    112010000000
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/falcon-financial-statements-api-64e0f1f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from falcon-comps.vercel.app](https://www.zero.xyz/host/falcon-comps.vercel.app/llms.txt)