# US Company Fundamentals (SEC)

> US Company Fundamentals (SEC) is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-29).

Returns reported financial fundamentals (revenue, earnings, cash flow, balance sheet, margins) for a US-listed company from SEC 10-K/10-Q filings, by ticker or CIK, for annual or quarterly periods.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/us-stocks/fundamentals?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-company-fundamentals-sec-d1eafa58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rSlnTR7SDRoYsdG9p3PYY

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 us-company-fundamentals-sec-d1eafa58
```

Example prompt: Pull the last 8 quarters of SEC-filed fundamentals for Apple (AAPL) — I need revenue, net income, diluted EPS, free cash flow, and total debt from its 10-Q filings.

## When to prefer this

Use this endpoint when you need actual SEC-filed financial figures (not analyst estimates or consensus forecasts) for a US-listed public company, for fundamental analysis, stock valuation, margin comparison, or historical financial trend review. Prefer this over earnings-estimate APIs when accuracy of reported numbers matters, or when building models based on GAAP-reported data.

## Known failure modes

- Unknown or invalid ticker returns an error or empty result
- Non-US or OTC-only tickers not covered by SEC EDGAR will fail
- Limit parameter out of range (must be 1-20) may return validation error
- Very small or newly listed companies may have sparse filing history
- Network or upstream EDGAR unavailability may cause timeout

## How this service works

Reported financials for a US-listed company from its SEC 10-K/10-Q filings: revenue, gross profit, operating and net income, diluted EPS, cash flow, capex, free cash flow, assets, liabilities, equity, cash, debt and margins, annual or quarterly. Use when analysing, comparing or valuing a US stock by ticker and you need filed numbers, not estimates.

## Output

Returns a structured list of financial periods (annual or quarterly), each containing income statement items (revenue, gross profit, operating income, net income, diluted EPS), cash flow items (operating cash flow, capex, free cash flow), balance sheet items (total assets, total liabilities, equity, cash, debt), and computed margin ratios — all as reported in SEC 10-K or 10-Q filings.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ticker"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Number of most recent periods, 1-20, default 5"
      },
      "period": {
       "enum": [
        "annual",
        "quarterly"
       ],
       "type": "string",
       "description": "Default annual"
      },
      "ticker": {
       "type": "string",
       "description": "US ticker such as AAPL or BRK-B, or a numeric SEC CIK"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-company-fundamentals-sec-d1eafa58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)