# Mekler AI Annual SEC Financial Facts

> Mekler AI Annual SEC Financial Facts is a paid API for AI agents from api.mekler.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-11).

Retrieves up to three years of annual US-GAAP financial facts (assets, liabilities, revenue, net income, cash, operating cash flow) for a US public company by CIK, with filing links and growth checks.

## Facts

- Endpoint: POST https://api.mekler.ai/v1/finance/companies/retrieve-annual-facts?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mekler-ai-annual-sec-financial-facts-6979510c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YklBywbv1RpnitYL0CuJe

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 mekler-ai-annual-sec-financial-facts-6979510c -d '<json body>'
```

Example prompt: Pull the last 3 years of annual SEC financial facts — assets, liabilities, revenue, net income, cash, and operating cash flow — for the company with CIK 0000320193, and include filing links.

## When to prefer this

Choose this endpoint when you need authoritative annual US-GAAP financial facts sourced directly from SEC EDGAR 10-K filings for US public companies, with direct filing links and accession numbers for citation. Prefer it over third-party financial data APIs when regulatory-grade sourcing and filing traceability matter. It is pay-per-call with no API key required, making it ideal for agents that need occasional lookups without subscription overhead.

## Known failure modes

- Invalid or non-existent CIK returns error or empty results
- Company uses non-standard US-GAAP tags — fields returned as missing status
- Company not a US public filer — no SEC data available
- Years parameter out of range (must be 1-3) — validation error
- Payment not completed via x402 — 402 Payment Required response
- Fields missing if company did not file a 10-K for a given year
- Snapshot input too large (exceeds 65,536 characters) — rejection

## How this service works

Dated topic news search, x402 service diagnostics, annual SEC financial facts, CSV validation, citation-source comparison, web extraction and email domain checks for agents. Find recent topic news with deduplicated source links and optional source-linked headline highlights; retrieve six annual US-GAAP USD fields by CIK with filing links, same-filing growth checks and optional observed revisions; check supplied CSV and citations; extract public page text, rendering JavaScript in a headless browser when needed; inspect email address syntax and mail-domain DNS. Pay per call with native USDC on Base or Solana via x402, without a separate API key. Wallet-first free trials cover CSV, column-spec, citation and static-page operations.

## Output

A JSON object containing up to three annual periods of six US-GAAP USD financial fields (assets, liabilities, revenue, net income, cash, operating cash flow), each with value, status, taxonomy tag, form type, accession number, filing URL, and period dates. Also includes coverage statistics, source URLs to SEC EDGAR submissions and company facts endpoints, any same-filing growth comparisons, retrieval timestamp, and selection policy used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": "string",
   "pattern": "^[0-9]{1,10}$"
  },
  "years": {
   "type": "integer",
   "default": 3,
   "maximum": 3,
   "minimum": 1
  },
  "snapshot": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 1
  },
  "quote_mode": {
   "enum": [
    "fast"
   ],
   "type": "string"
  },
  "include_revisions": {
   "type": "boolean",
   "default": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "years": [
   {
    "fields": {
     "cash": {
      "value": 35934000000,
      "status": "reported"
     },
     "assets": {
      "tag": "Assets",
      "form": "10-K",
      "unit": "USD",
      "filed": "2025-10-31",
      "value": 359241000000,
      "status": "reported",
      "taxonomy": "us-gaap",
      "accession": "0000320193-25-000079",
      "period_end": "2025-09-27",
      "period_start": null
     },
     "revenue": {
      "value": 416161000000,
      "status": "reported"
     },
     "net_income": {
      "value": 112010000000,
      "status": "reported"
     },
     "liabilities": {
      "value": 285508000000,
      "status": "reported"
     },
     "operating_cash_flow": {
      "value": 111482000000,
      "status": "reported"
     }
    },
    "period_end": "2025-09-27",
    "fiscal_year": 2025
   }
  ],
  "status": "ok",
  "sources": {
   "submissions": "https://data.sec.gov/submissions/CIK0000320193.json",
   "companyfacts": "https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json"
  },
  "coverage": {
   "complete": true,
   "returned_years": 1,
   "reported_fields": 6,
   "requested_years": 1,
   "requested_fields": 6
  },
  "comparisons": [],
  "limitations": [
   "US-GAAP standard whole-entity USD facts in annual 10-K/10-K/A only."
  ],
  "retrieved_at": "2026-10-05T00:00:00Z",
  "selection_policy": "latest-annual-filed-per-field-v1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mekler-ai-annual-sec-financial-facts-6979510c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.mekler.ai](https://www.zero.xyz/host/api.mekler.ai/llms.txt)