# EDGAR Company Financial Data Lookup

> EDGAR Company Financial Data 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 historical XBRL financial metrics (revenue, net income, assets, etc.) for any public company from the SEC EDGAR database by ticker, name, or CIK

## Facts

- Endpoint: POST https://api.firstmention.uk/s/edgar/company?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-company-financial-data-lookup-762af021
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rVrgAjKlNI8v2qhrxxE54

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-company-financial-data-lookup-762af021 -d '<json body>'
```

Example prompt: Pull Apple's annual revenue from SEC EDGAR for the last 6 years — use ticker AAPL, the Revenues XBRL tag, and limit results to 6 annual periods.

## When to prefer this

Choose this endpoint when you need structured, machine-readable financial fundamentals directly from SEC EDGAR XBRL data — especially for US public companies where official filing accuracy matters. Prefer this over web scraping or third-party financial data providers when auditability to the source filing is important, or when you need to search by CIK in addition to ticker. It is particularly well-suited for time-series financial analysis across fiscal years or quarters with a single API call.

## Known failure modes

- Unknown ticker or company name returns no match or empty result
- Invalid or non-existent XBRL tag returns an error or empty values array
- Company has no EDGAR filings (e.g. foreign private issuer) — no data returned
- Limit parameter out of range (outside 1-100) causes validation error
- Period filter mismatch — requesting annual for a metric only filed quarterly returns sparse results
- Payment failure via x402/USDC results in 402 response before data is returned

## 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 matching periods, the latest filing value with fiscal year and form type (10-K/10-Q), and a full time-series array of period values each with fiscal year, end date, form, and reported 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-company-financial-data-lookup-762af021/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)