# Stock Screener SEC Fundamentals

> Stock Screener SEC Fundamentals is a paid API for AI agents from api.boscolabs.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-13).

Screens all US SEC filers by financial fundamentals (revenue, net income, margins, cash flow, assets, and 30+ XBRL metrics) for a given calendar period, returning ranked company rows with official source links.

## Facts

- Endpoint: POST https://api.boscolabs.dev/v1/sec-company-screen?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stock-screener-sec-fundamentals-57e15a1d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nfmiyPupq9KfIbtq9CnTl

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 stock-screener-sec-fundamentals-57e15a1d -d '<json body>'
```

Example prompt: Screen all US SEC filers for the annual period CY2024, filter to companies with revenue above $500 million and a net margin above 15%, sort by free cash flow descending, and return the top 20 companies with their ticker, revenue, net income, and SEC source links.

## When to prefer this

Use this endpoint when you need to screen or rank US public companies using official SEC-reported XBRL fundamentals (revenue, margins, cash flow, assets, debt, EPS, etc.) for a specific calendar year or quarter. It is preferable to third-party financial data vendors when you require verifiable, source-linked data directly traceable to SEC EDGAR filings. Choose it over general web search or LLM-generated financial summaries when you need structured, filterable, multi-metric fundamental data across the full universe of US filers with per-row source citations.

## Known failure modes

- Invalid period format (must match CYYYYQn or CYYYY pattern) returns a 400 error
- Unsupported metric name in filters or sortBy returns a 400 validation error
- No companies match the filter criteria — returns empty rows array with no charge
- SEC EDGAR data not yet available for requested period — empty result or warning
- Overly restrictive filters yielding zero rows — no charge applied
- Network or upstream SEC EDGAR outage returns a 5xx error with no charge

## How this service works

Stock screener on SEC fundamentals: filter all US filers by revenue, net income, margins, cash flow, assets and 30 more XBRL metrics. Typical call $0.005: $0.002 per company returned, min $0.005. upto: pay only for delivered rows; exact: pays the quote (default 10 rows; set maxResults). Nothing is settled on an error or empty result. By Bosco Labs: official sources, source link per row.

## Output

A JSON array of company rows, each containing CIK, ticker, company name, period, period start/end date, requested metric values (e.g. revenue, net income, net margin, FCF), currency, SEC source links with EDGAR accession numbers and XBRL tag names for each reported field, any warnings, plus top-level metadata: total count, amount charged in USD, duration, and schema version.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "period": {
   "type": "string",
   "pattern": "^\\s*[Cc][Yy]\\d{4}([Qq][1-4])?\\s*$",
   "description": "Calendar period in SEC frames format: \"CY2025\" = annual figures, \"CY2025Q3\" = 3-month quarter..."
  },
  "sortBy": {
   "enum": [
    "revenue",
    "cost_of_revenue",
    "gross_profit",
    "research_and_development",
    "selling_general_and_administrative",
    "operating_profit",
    "profit_before_tax",
    "net_income",
    "net_income_attributable_to_parent",
    "eps_basic",
    "eps_diluted",
    "weighted_average_shares_basic",
    "weighted_average_shares_diluted",
    "depreciation_amortisation",
    "total_assets",
    "current_assets",
    "cash_and_equivalents",
    "total_liabilities",
    "current_liabilities",
    "noncurrent_liabilities",
    "long_term_debt",
    "total_equity",
    "equity_attributable_to_parent",
    "shares_outstanding",
    "operating_cash_flow",
    "investing_cash_flow",
    "financing_cash_flow",
    "capex",
    "dividends_paid",
    "free_cash_flow",
    "ebitda",
    "gross_margin",
    "operating_margin",
    "net_margin",
    "return_on_equity",
    "equity_ratio"
   ],
   "type": "string",
   "description": "Metric to rank by, e.g. \"operating_cash_flow\""
  },
  "filters": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "metric"
    ],
    "properties": {
     "metric": {
      "enum": [
       "revenue",
       "cost_of_revenue",
       "gross_profit",
       "research_and_development",
       "selling_general_and_administrative",
       "operating_profit",
       "profit_before_tax",
       "net_income",
       "net_income_attributable_to_parent",
       "eps_basic",
       "eps_diluted",
       "weighted_average_shares_basic",
       "weighted_average_shares_diluted",
       "depreciation_amortisation",
       "total_assets",
       "current_assets",
       "cash_and_equivalents",
       "total_liabilities",
       "current_liabilities",
       "noncurrent_liabilities",
       "long_term_debt",
       "total_equity",
       "equity_attributable_to_parent",
       "shares_outstanding",
       "operating_cash_flow",
       "investing_cash_flow",
       "financing_cash_flow",
       "capex",
       "dividends_paid",
       "free_cash_flow",
       "ebitda",
       "gross_margin",
       "operating_margin",
       "net_margin",
       "return_on_equity",
       "equity_ratio"
      ],
      "type": "string",
      "description
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "cik": "0000320193",
    "period": "CY2025",
    "ticker": "AAPL",
    "revenue": 416161000000,
    "sources": {
     "revenue": {
      "tag": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-...",
      "accession": "0000320193-26-000026"
     },
     "net_income": {
      "tag": "us-gaap:NetIncomeLoss",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/0000320193-...",
      "accession": "0000320193-26-000026"
     },
     "net_margin": {
      "derived": "net_income / revenue"
     }
    },
    "currency": "USD",
    "warnings": [],
    "net_income": 112010000000,
    "net_margin": 0.2692,
    "period_end": "2025-09-27",
    "company_name": "Apple Inc.",
    "period_start": "2024-09-29",
    "retrieved_at": "2026-11-05T22:18:21+00:00",
    "schema_version": "1"
   }
  ],
  "tool": "sec-company-screen",
  "count": 1,
  "message": "",
  "paid_via": "x402",
  "warnings": [],
  "balance_usd": 0,
  "charged_usd": 0.04,
  "duration_seconds": 1.2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stock-screener-sec-fundamentals-57e15a1d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boscolabs.dev](https://www.zero.xyz/host/api.boscolabs.dev/llms.txt)
