# SEC Metric Screener

> SEC Metric Screener 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).

Ranks all SEC XBRL filers by a single reported financial metric (revenue, net income, EPS, assets, etc.) for a given annual or quarterly period, enabling market-wide screens and league tables.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/us-stocks/screen?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/sec-metric-screener-3f64207a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q82DbkhV8Lsj6fr8_E5hn

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-metric-screener-3f64207a
```

Example prompt: Show me the top 25 US public companies ranked by revenue for full-year 2024, sorted largest first, pulled straight from SEC XBRL filings.

## When to prefer this

Use this endpoint when you need a cross-market ranking or screen of ALL SEC filers by a single fundamental metric for a specific period. It is ideal for building league tables, factor screens, or identifying market-wide outliers by financial fundamentals directly from XBRL source data. Prefer it over company-specific endpoints when the goal is comparative ranking rather than deep profiling of one company.

## Known failure modes

- Invalid metric alias or us-gaap tag returns an error or empty results
- Period format not matching CY2024, CY2025Q2, or CY2024Q4I conventions returns a bad request
- Limit exceeds 500 or is below 1 returns a validation error
- Metric not reported by many filers results in a sparse or short list
- Network timeout from the Render-hosted service under load

## How this service works

Rank every SEC filer by one reported metric for a period, straight from XBRL filings: revenue, net_income, operating_income, assets, cash, rnd, eps, stockholders_equity, long_term_debt, shares_outstanding or any us-gaap tag, for a year (CY2024) or quarter (CY2025Q2). Use for market-wide screens and league tables.

## Output

An ordered list of SEC filers ranked by the requested metric for the specified period, with each entry including company identifiers (name, ticker), the reported metric value, and period metadata — up to 500 results, sorted ascending or descending.

## 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": [],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Maximum number of results (1-500)"
      },
      "order": {
       "type": "string",
       "description": "desc (largest first) or asc"
      },
      "metric": {
       "type": "string",
       "description": "Metric alias or us-gaap tag"
      },
      "period": {
       "type": "string",
       "description": "CY2024, CY2025Q2 or CY2024Q4I"
      }
     }
    }
   },
   "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/sec-metric-screener-3f64207a/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)