# SEC EDGAR XBRL Normalized Financials

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

Returns normalized income statement, balance sheet, and cash flow data for a public company from SEC EDGAR XBRL filings, mapped to a clean unified schema with XBRL tag citations.

## Facts

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

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-a248c1e0
```

Example prompt: Pull the last 4 annual periods of income statement and balance sheet data for Apple (ticker AAPL) from SEC EDGAR — I want the figures normalized to a clean schema with XBRL tag citations so I can compare them.

## When to prefer this

Use this endpoint when you need structured, normalized public company financial statements from official SEC EDGAR filings with XBRL-level citation provenance, and want a compact JSON schema rather than parsing megabytes of raw XBRL. Prefer over raw EDGAR APIs when you need clean cross-company comparable schema, or over third-party financial data providers when you need regulatory-grade source citations tied to actual filings.

## Known failure modes

- Unknown ticker or CIK returns 404 or empty result
- Company has no XBRL filings (e.g. very small or foreign filers) returns no data
- Requesting too many periods (>12) fails schema validation
- Network or EDGAR upstream outage causes timeout
- Payment failure (x402) blocks the request if USDC not available

## 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 statement, balance sheet, cash flow — filtered by request) for the requested number of recent periods, each value mapped to its canonical XBRL tag and the specific SEC EDGAR filing it came from. Much smaller than raw XBRL, with clear provenance per data point.

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