# SEC EDGAR Company Brief (Composite)

> SEC EDGAR Company Brief (Composite) 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-30).

Returns a structured financial brief for a public company — including SEC filings, key financials, derived ratios, and risk-factor excerpts — sourced from SEC EDGAR data.

## Facts

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

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-company-brief-composite-76377573 -d '<json body>'
```

Example prompt: Can you pull a financial brief for Apple — ticker AAPL — including their latest 10-K filing, revenue trend, net margin, and up to 5 risk-factor excerpts?

## When to prefer this

Choose this endpoint when you need a composite, single-call financial brief combining SEC filing metadata, revenue financials, derived ratios, and risk-factor text for a US public company. Prefer it over raw EDGAR queries when you want pre-computed derived metrics and excerpts in one response rather than assembling multiple API calls yourself.

## Known failure modes

- Unknown ticker or company name returns no results or an error
- CIK not found in EDGAR returns empty response
- excerpts value outside 0-10 range may be rejected
- Payment failure (x402 USDC on Base) blocks the request
- Rate limiting or transient EDGAR upstream errors cause 5xx responses

## 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, SIC description, a list of recent SEC filings with URLs and form types, a financial time series for revenue (with latest value and historical series), derived metrics (net margin %, revenue YoY %), and an array of risk-factor excerpts from recent 10-K 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-company-brief-composite-76377573/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)