# StableFinance Stock Screener

> StableFinance Stock Screener is a paid API for AI agents from stablefinance.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Filter and screen publicly traded companies by fundamental financial criteria such as gross margin, revenue growth, sector, and more.

## Facts

- Endpoint: POST https://stablefinance.dev/api/financials/search/screener
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablefinance-dev-d2d09859
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lFBofa3ibXuxNTHLoi9Pv

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 stablefinance-dev-d2d09859 -d '<json body>'
```

Example prompt: Screen for technology sector companies with a gross margin above 60% and revenue growth above 20% — I'm looking for high-growth, high-margin software stocks to research.

## When to prefer this

Use this endpoint when you need to discover a set of companies meeting specific quantitative fundamental criteria — ideal for investment screening, building watchlists, or narrowing down a universe of stocks before deeper research. Prefer this over individual company lookups when you don't know which tickers to query and need discovery based on financial metrics.

## Known failure modes

- Invalid filter field name returns 400 error
- Out-of-range threshold values may return empty result set
- Unsupported sector or industry string returns no matches
- Payment failure (x402) if USDC balance insufficient
- Rate limiting if too many requests in quick succession
- Malformed POST body returns 400 or 422 validation error

## How this service works

Stock screener: filter by fundamental criteria. Screener tickers are not guaranteed on every downstream endpoint — before paid calls, check the target endpoint's /tickers list (e.g. /api/prices/snapshot/tickers, /api/financial-metrics/snapshot/tickers). Upstream invalid/unsupported tickers return 400/404 and are still charged.

## Output

A list of companies matching the specified fundamental criteria, likely including ticker symbols, company names, and the relevant financial metrics used for filtering such as gross margin percentages, revenue growth rates, sector classifications, and other requested fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1
  },
  "filters": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "field",
     "operator",
     "value"
    ],
    "properties": {
     "field": {
      "type": "string",
      "minLength": 1
     },
     "value": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       },
       {
        "type": "array",
        "items": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "number"
          },
          {
           "type": "boolean"
          }
         ]
        }
       }
      ]
     },
     "operator": {
      "enum": [
       "eq",
       "gt",
       "gte",
       "lt",
       "lte",
       "in"
      ],
      "type": "string"
     }
    },
    "additionalProperties": false
   },
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "ticker": "NVDA",
    "gross_margin": 0.7295,
    "report_period": "2024-01-28",
    "revenue_growth": 1.2585
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablefinance-dev-d2d09859/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablefinance.dev](https://www.zero.xyz/host/stablefinance.dev/llms.txt)