# EDGAR Financial Data Search

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

Searches SEC EDGAR for XBRL financial data (revenue, net income, EPS, etc.) for any public company by ticker, name, or CIK

## Facts

- Endpoint: POST https://api.firstmention.uk/s/edgar/search?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-search-6c009822
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-6myMbhvj3DXNWAtHZJI-

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-search-6c009822 -d '<json body>'
```

Example prompt: Pull Apple's annual revenue from SEC EDGAR for the last 5 years — search by ticker AAPL, using the Revenues tag, annual period, and return up to 5 results.

## When to prefer this

Use this endpoint when you need authoritative, SEC-sourced financial data for any U.S. public company — especially XBRL-tagged fundamentals like revenue, net income, assets, or EPS. Prefer it over web scraping or third-party financial data aggregators when regulatory accuracy and direct EDGAR provenance matter. It is ideal for AI agents doing equity research, financial modeling, or compliance checks that require structured, machine-readable fundamental data keyed by standard us-gaap taxonomy tags.

## Known failure modes

- Unknown ticker/company name returns no match or empty results
- Invalid or unsupported XBRL tag returns an error or empty values array
- CIK not found in EDGAR database returns a 404-style error
- Limit out of range (outside 1-100) may return a validation error
- Company has not filed the requested tag in XBRL format returns empty values
- Network or payment (x402 USDC) failure prevents the call from completing

## 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 XBRL taxonomy tag used, the unit of measure (e.g. USD), total count of filings found, the latest reported value with fiscal year and form type (10-K or 10-Q), and an array of historical values each with period, fiscal year, end date, form, and dollar 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-financial-data-search-6c009822/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)