# ScrapeMole Companies: SEC EDGAR Financials

> ScrapeMole Companies: SEC EDGAR Financials is a paid API for AI agents from companies.scrapemole.workers.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-12).

Retrieves XBRL financial metrics (revenue, net income, EPS, cash flow, balance sheet) for a US public company from SEC EDGAR, covering 5 annual years and 4 quarters.

## Facts

- Endpoint: GET https://companies.scrapemole.workers.dev/v1/financials?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scrapemole-companies-sec-edgar-financials-b60352ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MMdMOHXcD9vsrK2UNsZCS

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 scrapemole-companies-sec-edgar-financials-b60352ab
```

Example prompt: Pull Apple's revenue, net income, and EPS from SEC EDGAR — I want both the last 5 annual years and the most recent 4 quarters. Use ticker AAPL.

## When to prefer this

Choose this endpoint when you need structured, machine-readable financial statement data (income statement, balance sheet, cash flow) for US public companies sourced directly from SEC EDGAR XBRL filings. It is ideal for agents that need no API account setup, pay only per successful call in USDC, and require historically consistent multi-year or multi-quarter data. Prefer it over general financial data APIs when regulatory-grade, public-domain sourcing from SEC filings is important, or when you need specific XBRL concept-level data with filing provenance (accession number, form type, filed date).

## Known failure modes

- Missing ticker and CIK — both are optional but at least one must be provided; returns 400 if neither is given
- Unknown ticker or CIK — company not found in SEC EDGAR returns an error
- Metric name not recognized — invalid metric in the comma-separated list may return empty or error
- No XBRL data available — some smaller filers may not have machine-readable XBRL financials
- Payment failure — x402 payment not verified results in no charge and no response
- Rate limiting or network issues at the SEC EDGAR data source

## How this service works

Pay-per-call US company data for agents from SEC EDGAR (public domain): company/ticker search, company profiles (industry, incorporation, filer category, addresses, latest filings), XBRL financials (revenue, net income, EPS, cash flow, balance sheet; 5 years + 4 quarters) and filing lists with document links. USDC via x402, no accounts; failed calls are never charged.

Payments: x402 v2, scheme "exact", USDC on Base (eip155:8453). The payment is verified before the work and settled only when the response is 200. Terms: https://companies.scrapemole.workers.dev/terms

## Output

Returns a JSON object containing the company's CIK, name, ticker, and a metrics map. Each requested metric includes its XBRL concept name, unit (e.g. USD), an annual array of up to 5 fiscal year data points, and a quarterly array of up to 4 recent quarters. Each data point includes fiscal period, fiscal year, start/end dates, filing accession number, form type, filed date, and the reported value. Also includes currency and shares outstanding with an as-of date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC CIK. Give ticker or cik."
      },
      "ticker": {
       "type": "string",
       "examples": [
        "AAPL"
       ],
       "description": "Stock ticker, e.g. AAPL. Give ticker or cik."
      },
      "metrics": {
       "type": "string",
       "description": "Comma-separated subset, e.g. \"revenue,netIncome\". Default all."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": 320193,
  "name": "Apple Inc.",
  "ticker": "AAPL",
  "metrics": {
   "revenue": {
    "unit": "USD",
    "annual": [
     {
      "fp": "FY",
      "fy": 2025,
      "end": "2025-09-27",
      "accn": "0000320193-25-000079",
      "form": "10-K",
      "filed": "2025-10-31",
      "start": "2024-09-29",
      "value": 416161000000
     }
    ],
    "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
    "quarterly": [
     {
      "fp": "Q3",
      "fy": 2026,
      "end": "2026-06-27",
      "accn": "0000320193-26-000020",
      "form": "10-Q",
      "filed": "2026-07-31",
      "start": "2026-03-29",
      "value": 109417000000
     }
    ]
   }
  },
  "currency": "USD",
  "sharesOutstanding": {
   "asOf": "2026-07-17",
   "form": "10-Q",
   "value": 14594180000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrapemole-companies-sec-edgar-financials-b60352ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companies.scrapemole.workers.dev](https://www.zero.xyz/host/companies.scrapemole.workers.dev/llms.txt)