# SEC EDGAR Composite Filings & Financials Lookup

> SEC EDGAR Composite Filings & Financials Lookup is a paid API for AI agents from api.firstmention.uk, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns a composite view of a public company's SEC filings, derived financials, and risk-factor excerpts by ticker, name, or CIK

## Facts

- Endpoint: POST https://api.firstmention.uk/s/composite/filings?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-composite-filings-financials-lookup-fa30edba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CpJ6QhMAVaAkm4FTHrE7H

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-composite-filings-financials-lookup-fa30edba -d '<json body>'
```

Example prompt: Pull the composite SEC EDGAR filing data for Apple (AAPL), including their latest 10-K financials and up to 5 risk-factor excerpts.

## When to prefer this

Use this endpoint when you need a single composite call that aggregates SEC EDGAR filings, derived financial metrics, and risk-factor excerpts for a US public company. It is preferable over raw EDGAR queries when you want pre-computed YoY growth and net margin alongside filing history and risk text in one response, and when you are operating in an x402/USDC payment context on Base.

## Known failure modes

- Unknown ticker or company name returns no results or an error
- CIK not found in EDGAR database returns empty or 404-style response
- Invalid excerpts value (outside 0-10) may cause a validation error
- Company with no filed financials may return partial data
- Payment failure via x402/USDC blocks the request before processing

## How this service works

Pay-per-call HTTP APIs, paid with x402 in USDC on Base (eip155:8453): agentkit, api-change-check, basedue, basewatch, chainread, check-sanctions, chgwatch, company-facts, composite, edgar, feednews, pageaudit, solcheck, token-dd, txpreflight, walletcheck, webmd, webread, websearch, x402index. Each operation describes its service.

## Output

A JSON object containing the company's CIK, name, tickers, and SIC description; a list of SEC filings with form type, date, and URL; derived metrics including net margin percentage and revenue year-over-year growth; historical revenue series; and up to 10 risk-factor text excerpts from recent filings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Ticker, company name or CIK, e.g. AAPL, nvidia, 320193"
  },
  "excerpts": {
   "type": "integer",
   "description": "Max risk-factor excerpts (0-10)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "SEC EDGAR public data",
  "company": {
   "cik": 320193,
   "name": "Apple Inc.",
   "tickers": [
    "AAPL"
   ],
   "sic_description": "Electronic Computers"
  },
  "derived": {
   "net_margin_pct": 42.17,
   "revenue_yoy_pct": 322.25
  },
  "filings": [
   {
    "url": "https://www.sec.gov/Archives/...",
    "form": "10-K",
    "filed": "2026-10-20"
   }
  ],
  "financials": {
   "revenue": {
    "unit": "USD",
    "latest": 265595000000,
    "series": [
     {
      "fy": 2018,
      "end": "2018-09-29",
      "value": 265595000000
     }
    ]
   }
  },
  "risk_excerpts": [
   {
    "form": "10-K",
    "filed": "2026-10-20",
    "company": "Apple Inc."
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-composite-filings-financials-lookup-fa30edba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.firstmention.uk](https://www.zero.xyz/host/api.firstmention.uk/llms.txt)
