# SEC Financials API

> SEC Financials API is a paid API for AI agents from golf-evm-math.x402-evm-math.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-28).

Retrieves key financial metrics (revenue, net income, EPS, assets, liabilities, cash, operating cash flow) for US public companies from SEC XBRL filings, supporting annual and quarterly periods, via ticker, CIK, or company name.

## Facts

- Endpoint: GET https://golf-evm-math.x402-evm-math.workers.dev/company/financials?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-financials-api-a41f2eec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_446PZMzJkC7NUniC431Gg

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 sec-financials-api-a41f2eec
```

Example prompt: Pull the latest annual revenue, net income, and EPS for NVIDIA from SEC EDGAR filings — I want the XBRL-sourced numbers with the period end date.

## When to prefer this

Prefer this endpoint when you need machine-readable, SEC-official financial figures sourced directly from XBRL filings for US public companies — especially for revenue, net income, EPS, assets, liabilities, and cash flow — and you want structured data per period (annual or quarterly) queryable by ticker, CIK, or name. Choose this over generic finance APIs when regulatory-source accuracy and XBRL provenance matter.

## Known failure modes

- Unknown ticker, CIK, or company name returns an error or empty result
- Company has no XBRL filings available (e.g. very small or foreign-only filers)
- Requested period not available in SEC XBRL data
- Rate limit or payment failure returns 402 or 429
- Partial data if company only reports select XBRL tags

## How this service works

Exact EVM address, calldata, Uniswap V2/V3 and impermanent-loss math. Pay per call in USDC on Base via x402.

## Output

Returns structured financial data parsed from SEC XBRL filings, including revenue, net income, EPS, total assets, total liabilities, cash, and operating cash flow for the requested period (annual or quarterly), with each metric's value and associated period end 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "annual": {
   "revenue": {
    "value": 215938000000,
    "period_end": "2026-01-25"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-financials-api-a41f2eec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from golf-evm-math.x402-evm-math.workers.dev](https://www.zero.xyz/host/golf-evm-math.x402-evm-math.workers.dev/llms.txt)