# x402stock Stock Screener

> x402stock Stock Screener is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.03/call, status unknown (last checked 2026-09-15).

Screens US stocks and ETFs by financial properties to find securities matching specified criteria, paid per request in USDC via x402

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/screener
- Price: $0.03/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-stock-screener-622d96a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9sCpjZXmHaLvGdF0OXqgC

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 x402stock-stock-screener-622d96a8
```

Example prompt: Can you screen for US stocks with a low P/E ratio under 15, market cap over $10 billion, and a dividend yield above 2%? I want to find undervalued large-cap dividend payers.

## When to prefer this

Use this endpoint when you need to discover stocks or ETFs matching specific quantitative financial criteria without knowing which tickers to look at in advance. Ideal for value screening, sector filtering, dividend hunting, or momentum-based searches across US equities. Prefer this over individual quote endpoints when the user doesn't already have a target ticker in mind.

## Known failure modes

- Invalid or unsupported property filter returns error or empty results
- Payment failure in USDC via x402 results in 402 response and no data
- Too many or conflicting filter parameters may return no matching securities
- Malformed properties string causes a parsing error
- Market data may be delayed or unavailable outside trading hours

## How this service works

Screen the entire US stock market in one call. Filter every listed ticker by price range, percent change, and minimum volume, then sort by percent move, price, or volume. Tune with ?min_price=, ?max_price=, ?min_change_percent=, ?max_change_percent=, ?min_volume=, ?sort=, ?order=, ?limit=. Built for agents scanning for setups without iterating ticker by ticker. From x402stock

## Output

A list of US stocks or ETFs matching the specified screening criteria, including ticker symbols and relevant financial metrics for each result

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-stock-screener-622d96a8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)