# SEC EDGAR Composite Watchlist Lookup

> SEC EDGAR Composite Watchlist 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 comprehensive financial profile for a public company from SEC EDGAR, including financials, filings, derived metrics, and risk-factor excerpts, paid per-call with USDC via x402.

## Facts

- Endpoint: POST https://api.firstmention.uk/s/composite/watchlist?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-watchlist-lookup-d8ca108c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JTnPnBPOA71mciu_sqwtQ

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-watchlist-lookup-d8ca108c -d '<json body>'
```

Example prompt: Can you pull the full financial profile for Apple (AAPL) from SEC EDGAR — I want the latest revenue, net margin, year-over-year growth, recent 10-K filings, and up to 5 risk-factor excerpts.

## When to prefer this

Use this endpoint when you need a single-call, structured financial and filing profile for a public US company, especially when you need SEC-sourced data including risk factors and filing URLs. Prefer this over raw EDGAR queries when you want derived metrics like net margin and YoY revenue growth pre-computed. Best suited for due diligence, portfolio monitoring, and compliance workflows where SEC data authority matters.

## Known failure modes

- Unknown ticker, name, or CIK returns an error or empty result
- CIK lookup ambiguity if multiple companies match a name query
- Stale or delayed data if SEC EDGAR has not yet indexed the latest filing
- Payment failure if USDC balance is insufficient or x402 handshake fails
- excerpts value outside 0-10 range may cause validation error

## 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, derived metrics (net margin %, revenue YoY %), a list of SEC filings with URLs and form types, a full revenue time series in USD, and optional risk-factor text excerpts from recent 10-K or similar 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-watchlist-lookup-d8ca108c/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)