# SEC EDGAR XBRL Normalized Financials

> SEC EDGAR XBRL Normalized Financials is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-11).

Fetches normalized income statement, balance sheet, and cash flow data from SEC EDGAR XBRL filings for a given ticker or CIK, mapped to a clean unified schema with XBRL citations.

## Facts

- Endpoint: GET https://api.agentstools.dev/edgar/financials?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-xbrl-normalized-financials-20f18b70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fmAVd34UYl3Ny0IvRax8u

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-edgar-xbrl-normalized-financials-20f18b70
```

Example prompt: Pull the last 4 annual periods of income statement and balance sheet data for AAPL from SEC EDGAR filings — I want clean normalized numbers with their XBRL tags.

## When to prefer this

Use this endpoint when you need structured, citation-backed financial statement data from official SEC EDGAR XBRL filings without the overhead of parsing raw XBRL yourself. Prefer this over scraping financial data sites when auditability and XBRL-level citation to real filings matters, or when you need a normalized schema that lets you compare multiple companies consistently.

## Known failure modes

- Ticker not found in EDGAR — returns error if ticker cannot be resolved to a CIK
- CIK does not exist or has no XBRL filings — empty or error response
- Requested periods exceed available filing history — returns fewer periods than requested
- Invalid frequency or statement filter values — schema validation error
- Rate limit or payment failure (x402) — 402 Payment Required response

## How this service works

Normalized company financials from SEC EDGAR XBRL filings. Give a ticker or CIK and get income statement, balance sheet and cash flow lines mapped to one clean schema, each value cited to its real XBRL tag and filing. Compact cited JSON instead of megabytes of raw XBRL.

## Output

A compact JSON object containing normalized financial statement lines (income, balance sheet, cash flow as requested) for the specified company and periods, each value tagged with its original XBRL concept name and linked to its source SEC filing — no raw XBRL megabytes, just clean cited data.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC EDGAR CIK, any zero-padding accepted"
      },
      "freq": {
       "enum": [
        "annual",
        "quarterly"
       ],
       "type": "string",
       "description": "Reporting frequency, default annual"
      },
      "ticker": {
       "type": "string",
       "description": "Stock ticker symbol, e.g. AAPL"
      },
      "periods": {
       "type": "integer",
       "maximum": 12,
       "minimum": 1,
       "description": "Number of recent periods to return, default 8"
      },
      "statements": {
       "type": "array",
       "items": {
        "enum": [
         "income",
         "balance",
         "cashflow"
        ],
        "type": "string"
       },
       "description": "Optional filter of which statements to return"
      }
     }
    }
   },
   "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/sec-edgar-xbrl-normalized-financials-20f18b70/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)