# x402 Agent Hub – SEC XBRL Company Financials

> x402 Agent Hub – SEC XBRL Company Financials is a paid API for AI agents from x402-agent-hub.x402-agent-hub.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-14).

Returns reported US-GAAP financial fundamentals (revenue, income, EPS, cash flow, margins, growth) from SEC XBRL data for up to 12 annual or quarterly periods for any US-listed company.

## Facts

- Endpoint: GET https://x402-agent-hub.x402-agent-hub.workers.dev/v1/company/financials?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agent-hub-sec-xbrl-company-financials-edd49ca1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HAMR2UWg9jFIdjdtBtlrp

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 x402-agent-hub-sec-xbrl-company-financials-edd49ca1
```

Example prompt: Pull Apple's last 8 annual periods of SEC GAAP financials — I want revenue, net income, free cash flow, diluted EPS, and net margin for AAPL.

## When to prefer this

Choose this endpoint when you need standardized US-GAAP reported financials (revenue, income, EPS, cash flow, margins) sourced directly from SEC XBRL submissions for any US-listed public company. It is ideal for fundamental analysis, valuation models, earnings research, and financial dashboards where authoritative reported figures — not estimated or scraped data — are required. It covers both annual and quarterly periods (up to 12) and charges only on successful reads, making it cost-safe for exploratory queries. Prefer alternatives if you need non-US companies, real-time earnings estimates, or analyst consensus data.

## Known failure modes

- Invalid or unrecognized ticker symbol returns not-found error with no charge
- CIK not found in SEC EDGAR returns not-found error with no charge
- Requesting more than 12 periods returns input validation error
- Company has no XBRL filings (e.g. non-US or non-GAAP filers) returns not-found
- Upstream SEC EDGAR outage returns upstream error with no charge
- Quarterly cash flow figures derived from YTD filings may be flagged as estimated

## How this service works

Reported fundamentals for US-GAAP filers from SEC XBRL data: revenue, operating income, net income, diluted EPS, operating cash flow, capex, free cash flow, total assets/liabilities, equity, cash, margins and YoY revenue growth for the last 1-12 annual or quarterly periods. Q4 and quarterly cash flows are derived from year-to-date filings and flagged. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement.

## Output

A JSON object containing the company's name, ticker, and CIK, the period type (annual or quarterly), the currency (USD), and an array of period objects each with: period end date, fiscal year, revenue, net income, operating income, diluted EPS, operating cash flow, capex, free cash flow, total assets, total liabilities, equity, cash, net margin percent, and revenue YoY growth percent. Derived Q4/quarterly cash flow values are flagged. Charges $0.005 USDC only on successful reads; invalid inputs or upstream errors cancel settlement.

## 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": {
      "cik": {
       "type": "string",
       "description": "SEC Central Index Key, e.g. 320193 (alternative to ticker)."
      },
      "limit": {
       "type": "string",
       "description": "Number of periods, 1-12 (default 4)."
      },
      "period": {
       "type": "string",
       "description": "annual (default) or quarterly."
      },
      "ticker": {
       "type": "string",
       "description": "US stock ticker, e.g. AAPL or BRK.B. Provide ticker or cik."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "period": "annual",
  "company": {
   "cik": 320193,
   "name": "Apple Inc.",
   "ticker": "AAPL"
  },
  "periods": [
   {
    "revenue": 416161000000,
    "netIncome": 112010000000,
    "periodEnd": "2025-09-27",
    "epsDiluted": 7.46,
    "fiscalYear": 2025,
    "freeCashFlow": 98767000000,
    "netMarginPercent": 26.92,
    "revenueGrowthYoYPercent": 6.43
   }
  ],
  "currency": "USD"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agent-hub-sec-xbrl-company-financials-edd49ca1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-hub.x402-agent-hub.workers.dev](https://www.zero.xyz/host/x402-agent-hub.x402-agent-hub.workers.dev/llms.txt)
