# OpenData402 SEC XBRL Annual Financials

> OpenData402 SEC XBRL Annual Financials is a paid API for AI agents from opendata402.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-15).

Retrieves key annual financial metrics (revenue, income, EPS, assets, liabilities, equity, cash) from SEC XBRL 10-K filings for a US-listed company, by ticker or CIK, up to 10 years.

## Facts

- Endpoint: GET https://opendata402.com/v1/sec/financials?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/opendata402-sec-xbrl-annual-financials-f612876d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WV8fTmLrT5AUEPx4RroZj

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 opendata402-sec-xbrl-annual-financials-f612876d
```

Example prompt: Pull the last 7 years of annual financials for Apple — ticker AAPL — from their SEC 10-K filings: I need revenue, net income, diluted EPS, total assets, and cash.

## When to prefer this

Choose this endpoint when you need structured, multi-year annual financial fundamentals for a US public company sourced directly from official SEC XBRL 10-K filings. It is ideal for equity research, peer comparisons, and trend analysis where data provenance and regulatory accuracy matter. Prefer it over third-party financial data APIs when you need verifiable public-domain SEC data at low cost per call. Not suitable for real-time stock prices, quarterly breakdowns, or non-US companies.

## Known failure modes

- Unknown ticker or CIK returns an error or empty result
- Company has not filed XBRL-formatted 10-Ks (e.g. very small or recently listed companies)
- Years parameter out of range (must be 1–10) returns a validation error
- Non-US-listed companies are not covered
- Ticker format violation (e.g. too long or invalid characters) returns schema validation error
- Recently filed 10-Ks may not yet be indexed in EDGAR XBRL

## How this service works

Key annual financials of a US-listed company from its SEC XBRL filings (10-K), by ticker or CIK: revenue, operating income, net income, diluted EPS, total assets, liabilities, equity and cash, per fiscal year with the filing it comes from, up to 10 years. Use it for quick fundamentals and peer comparisons. SEC data, US public domain.

## Output

A structured JSON response containing per-fiscal-year rows of key financial metrics — revenue, operating income, net income, diluted EPS, total assets, total liabilities, shareholders equity, and cash — along with the fiscal year label and the SEC filing (10-K) it was sourced from, covering up to 10 years of history.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string",
       "pattern": "^[0-9]{1,10}$",
       "description": "SEC Central Index Key."
      },
      "years": {
       "type": "string",
       "pattern": "^([1-9]|10)$",
       "description": "Latest fiscal years (default 5, max 10)."
      },
      "ticker": {
       "type": "string",
       "pattern": "^[A-Za-z.-]{1,10}$",
       "description": "Stock ticker, e.g. AAPL."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/opendata402-sec-xbrl-annual-financials-f612876d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opendata402.com](https://www.zero.xyz/host/opendata402.com/llms.txt)