# EDGAR Financials Lookup

> EDGAR 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).

Retrieves structured financial data (revenue, income, assets, EPS, etc.) for any public company from SEC EDGAR filings using ticker, company name, or CIK.

## Facts

- Endpoint: POST https://api.firstmention.uk/s/edgar/financials?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/edgar-financials-lookup-82d07274
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IrIra4QTUQmnYf5OcEPWs

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 edgar-financials-lookup-82d07274 -d '<json body>'
```

Example prompt: Pull Apple's annual revenue from SEC EDGAR for the last 5 years — use ticker AAPL, the 'revenue' tag, annual period, and give me up to 5 results.

## When to prefer this

Choose this endpoint when you need structured, machine-readable financial fundamentals (revenue, income, assets, EPS, cash) sourced directly from official SEC EDGAR XBRL filings for any US-listed public company. It is preferable over web scraping or market data APIs when auditability and GAAP-tagged data are required, and when cost-efficiency matters at $0.01 per call via x402/USDC.

## Known failure modes

- Unknown ticker, name, or CIK returns no match or empty results
- Invalid or unsupported XBRL tag returns an error or empty values array
- Limit outside 1-100 range may be rejected or clamped
- Company has no EDGAR filings (foreign private issuers) returns no data
- Network or payment failure returns HTTP 402 if USDC payment is not processed

## 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

Returns a JSON object containing the matched company (CIK, name, ticker), the resolved XBRL tag and taxonomy, the unit of measure (e.g. USD), a count of results, the latest filing value with fiscal year and form type, and an array of historical period values each with fiscal period, fiscal year, end date, form type, and value.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Ticker, company name or CIK, e.g. AAPL, nvidia, 320193"
  },
  "tag": {
   "type": "string",
   "description": "XBRL tag or alias: revenue, net_income, assets, cash, eps, or any us-gaap tag"
  },
  "limit": {
   "type": "integer",
   "description": "Max results (1-100)"
  },
  "period": {
   "enum": [
    "all",
    "annual",
    "quarterly"
   ],
   "type": "string",
   "description": "all, annual or quarterly"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": 320193,
  "tag": "Revenues",
  "name": "Apple Inc.",
  "unit": "USD",
  "count": 6,
  "latest": {
   "fy": 2025,
   "end": "2025-09-27",
   "form": "10-K",
   "value": 416161000000
  },
  "period": "annual",
  "values": [
   {
    "fp": "FY",
    "fy": 2025,
    "end": "2025-09-27",
    "form": "10-K",
    "value": 416161000000
   }
  ],
  "matched": {
   "cik": 320193,
   "name": "Apple Inc.",
   "ticker": "AAPL"
  },
  "taxonomy": "us-gaap"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-financials-lookup-82d07274/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)