# EDGAR Financial Data Resolver

> EDGAR Financial Data Resolver 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).

Resolves a company ticker, name, or CIK to structured XBRL financial data (e.g. revenue, net income, EPS) from SEC EDGAR filings

## Facts

- Endpoint: POST https://api.firstmention.uk/s/edgar/resolve?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-financial-data-resolver-43e4f245
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_L3wjxtensXLBAfZUtRbax

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-financial-data-resolver-43e4f245 -d '<json body>'
```

Example prompt: Look up Apple's annual revenue for the last 5 years from SEC EDGAR — the ticker is AAPL, I want the 'revenue' tag, annual period, and up to 5 results.

## When to prefer this

Choose this endpoint when you need structured, historically accurate financial data directly from SEC EDGAR filings, particularly when you need XBRL-tagged values like revenue, net income, EPS, or total assets for public US companies. Prefer this over web scraping or news-based financial data when precision, official sourcing, and fiscal period filtering (annual vs quarterly) matter. It pays per call in USDC via x402, making it suitable for lightweight, on-demand agent workflows without subscription overhead.

## Known failure modes

- Unknown or misspelled ticker/company name returns no match
- Invalid or unsupported XBRL tag returns an error or empty result
- CIK not found for ambiguous company name queries
- Limit parameter out of range (must be 1–100) causes validation error
- Period enum value not matching 'all', 'annual', or 'quarterly' causes rejection
- Payment failure via x402/USDC results in 402 Payment Required response

## 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 with the resolved company's CIK, name, and ticker; the matched XBRL tag and taxonomy; the unit of measurement; and an array of financial values per fiscal period including fiscal year, end date, form type (e.g. 10-K), and the reported numeric value. Also includes a 'latest' field highlighting the most recent filing.

## 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-financial-data-resolver-43e4f245/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)