# falcon.sol comps

> falcon.sol comps is a paid API for AI agents from falcon-comps.falcon-sol.workers.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-11-01).

Returns standardized financial statements and trading comps for a US-listed company sourced from SEC EDGAR, billed per call via x402.

## Facts

- Endpoint: POST https://falcon-comps.falcon-sol.workers.dev/v1/financials?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/falcon-sol-comps-fda9959c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aX5ZY17dnB01UaN1X57ck

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-sol-comps-fda9959c -d '<json body>'
```

Example prompt: Pull the standardized SEC EDGAR financials for Apple — ticker AAPL — covering the last 5 years, including TTM revenue, net income, and gross margin ratios.

## When to prefer this

Choose this endpoint when you need machine-readable, normalized financial statement data sourced directly from SEC EDGAR for US-listed companies, especially when you want consistent multi-year income statement arrays and TTM metrics without scraping or parsing raw XBRL filings yourself. Prefer it over general financial data APIs when EDGAR provenance and standardization matter, or when you need programmatic access priced per call rather than a subscription.

## Known failure modes

- Invalid or unrecognized ticker returns an error or empty result
- CIK not found in SEC EDGAR returns 404-equivalent payload
- Years parameter exceeding 15 or below 1 triggers validation error
- Payment failure via x402 protocol blocks the request
- Company with insufficient EDGAR filing history returns partial data
- Non-US ticker or OTC-only security may not be supported

## How this service works

Standardized financials and trading comps from SEC EDGAR, paid per call with x402.

## Output

A JSON object containing the company ticker, TTM financials (as-of date and revenue), multi-year income statement arrays (revenue and net income per fiscal year), fiscal year end dates, and computed ratios such as gross margin. Data is normalized from SEC EDGAR filings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "years": {
   "type": "integer",
   "default": 5,
   "maximum": 15,
   "minimum": 1
  },
  "ticker": {
   "type": "string",
   "description": "US ticker (AAPL, BRK.B) or SEC CIK"
  }
 }
}
```

## 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-sol-comps-fda9959c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from falcon-comps.falcon-sol.workers.dev](https://www.zero.xyz/host/falcon-comps.falcon-sol.workers.dev/llms.txt)