# SEC Financial Facts by Ticker

> SEC Financial Facts by Ticker is a paid API for AI agents from x402-gateway.blackwoodstate8.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-23).

Returns a US-listed company's last two fiscal years of key annual financials (revenue, net income, EPS, cash flow, balance sheet) sourced directly from SEC filings for 0.02 USDC per call.

## Facts

- Endpoint: POST https://x402-gateway.blackwoodstate8.workers.dev/v1/sec-facts?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-financial-facts-by-ticker-45c66410
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RHe8J3ERyFEFnjS9ai6db

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 sec-financial-facts-by-ticker-45c66410 -d '<json body>'
```

Example prompt: Pull the last two fiscal years of annual financials for NVDA from SEC filings — I need revenue, net income, diluted EPS, operating cash flow, and the year-end balance sheet.

## When to prefer this

Choose this endpoint when you need structured annual financial fundamentals (revenue, income, EPS, cash flow, balance sheet) for a US-listed company directly from SEC filings, covering the last two fiscal years, at a low per-call cost of $0.02 USDC. Prefer this over general financial data APIs when you need SEC-sourced data accuracy, or when working within an x402 micropayment-enabled agent pipeline. Do not use if you need quarterly figures, real-time prices, non-US companies, or data older than two fiscal years.

## Known failure modes

- Invalid or non-existent ticker returns an error
- Non-US company tickers not filing with SEC will fail
- Quarterly data not available — only annual figures returned
- Filings older than two fiscal years are not included
- Rate limiting or payment failure for the 0.02 USDC micropayment
- Companies with no SEC EDGAR history return empty or error response

## How this service works

Use when you need sec filings company financials, earnings or fundamentals for a stock ticker for the last two fiscal years. Do not use for quarterly numbers, real-time prices, non-US companies or filings older than two years. Returns JSON with a US-listed company's annual revenue, net and operating income, diluted EPS, operating cash flow and year-end balance sheet from SEC filings for 0.02 USDC per call. Typical response time 300 ms (p95). Category: Data.

## Output

Returns a JSON object containing the company's CIK, name, exchange, currency (USD), and an array of fiscal year objects (for the last two years) each with start/end dates, revenue, net income, operating income, diluted EPS, operating cash flow, and accession number. Also includes a top-level balance sheet object and a 'next' field suggesting a follow-up call in the same family.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "ticker": {
       "type": "string",
       "pattern": "^[A-Za-z][A-Za-z0-9.\\-]{0,9}$",
       "description": "Stock ticker of a company that files with the SEC, e.g. AAPL"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "ticker",
      "cik",
      "name",
      "exchange",
      "currency",
      "fiscalYears",
      "balanceSheets",
      "source",
      "dataUpdatedAt"
     ],
     "properties": {
      "cik": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": -9007199254740991
      },
      "name": {
       "type": "string"
      },
      "next": {
       "type": "object",
       "required": [
        "service",
        "tool",
        "method",
        "url",
        "useWhen",
        "sample"
       ],
       "properties": {
        "url": {
         "type": "string",
         "description": "Paid route of the next call"
        },
        "tool": {
         "type": "string",
         "description": "MCP tool name of the same call"
        },
        "method": {
         "enum": [
          "GET",
          "POST"
         ],
         "type": "string"
        },
        "sample": {
         "type": "string",
         "description": "Free fixed sample of the whole family"
        },
        "service": {
         "type": "string",
         "description": "Service id of the suggested next paid call"
        },
        "useWhen": {
         "type": "string",
         "description": "When the next call is the right one"
        }
       },
       "description": "Suggested next paid call in the same family (call it in a loop when the task continues)",
       "additionalProperties": false
      },
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": 320193,
  "name": "Apple Inc.",
  "source": "SEC EDGAR XBRL frames (data.sec.gov)",
  "ticker": "AAPL",
  "currency": "USD",
  "exchange": "Nasdaq",
  "fiscalYears": [
   {
    "end": "2025-09-27",
    "accn": "0000320193-25-000079",
    "start": "2024-09-29",
    "revenue": 416161000000,
    "netIncome": 112010000000,
    "epsDiluted": 7.46,
    "calendarYear": 2025,
    "operatingIncome": 133050000000,
    "operatingCashFlow": 111482000000
   },
   {
    "end": "2024-09-28",
    "accn": "0000320193-25-000079",
    "start": "2023-10-01",
    "revenue": 391035000000,
    "netIncome": 93736000000,
    "epsDiluted": 6.08,
    "calendarYear": 2024,
    "operatingIncome": 123216000000,
    "operatingCashFlow": 118254000000
   }
  ],
  "balanceSheets": [
   {
    "asOf": "2025-12-27",
    "cash": 45317000000,
    "assets": 379297000000,
    "equity": 88190000000,
    "liabilities": 291107000000,
    "calendarYear": 2025
   },
   {
    "asOf": "2024-12-28",
    "cash": 30299000000,
    "assets": 344085000000,
    "equity": 66758000000,
    "liabilities": 277327000000,
    "calendarYear": 2024
   }
  ],
  "dataUpdatedAt": "2026-10-16T15:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-financial-facts-by-ticker-45c66410/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-gateway.blackwoodstate8.workers.dev](https://www.zero.xyz/host/x402-gateway.blackwoodstate8.workers.dev/llms.txt)