# x402stock Smart Stock Screener > x402stock Smart Stock Screener is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.2/call, status healthy (last checked 2026-09-14, last successful call 2026-09-02). Screens the entire US stock market using a natural language query, returning tickers that match technical signals like oversold conditions, momentum, and volume with AI-generated rationales. ## Facts - Endpoint: GET https://x402stock.xyz/api/v1/screener/smart - Price: $0.2/call - Payment: x402 - Status: healthy - Last checked: 2026-09-14 - Last successful call: 2026-09-02 - Activations on Zero: 1 - Tags: x402 - Canonical page: https://www.zero.xyz/c/x402stock-smart-stock-screener-d57bf87d - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UqjvtUtDTxSoSjhNWXM1i 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-smart-stock-screener-d57bf87d ``` Example prompt: Can you screen the US stock market for large cap stocks that are oversold right now — RSI under 30 — but are up today on high volume, price above $20, sort by biggest gainers, and give me the top 10 with a reason why each one stands out? ## When to prefer this Use this endpoint when you need to discover stock tickers matching a technical or thematic screen expressed in plain English — especially when you don't know which specific tickers to look at and want AI to interpret your criteria and return a ranked, reasoned shortlist. Prefer this over point-in-time price lookups when the goal is discovery rather than data retrieval for a known symbol. ## Known failure modes - Missing required 'q' query parameter returns 400 error - Ambiguous or very broad natural language query may return empty results or low-relevance tickers - Payment not made or insufficient USDC results in 402 Payment Required - Market data may be delayed, causing mismatch between stated conditions and real-time prices - Very restrictive filter combinations (e.g. very low price + very high volume + RSI < 20) may yield zero results ## How this service works Describe a screen in plain English via `?q=` (e.g. 'oversold large caps up today on high volume'). An LLM parses it into a filter, screens the entire US market, optionally confirms oversold/overbought with RSI, and returns a ranked shortlist with a one-line rationale per name. No need to know the filter schema or run the enrichment loop yourself. From x402stock ## Output Returns a JSON object with the interpreted natural language query, the filters extracted from it (price range, volume threshold, RSI signal, sort order, limit), and an array of matching tickers each with price, percent change, volume, RSI value, and an AI-generated rationale explaining why it matched. Also includes a plain-English summary of results, a disclaimer, and section-level status indicators. ## Example request ```json { "input": { "type": "http", "method": "GET", "queryParams": { "q": "technology stocks with high volume" } } } ``` ## 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", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "q" ], "properties": { "q": { "type": "string", "minLength": 1 } }, "additionalProperties": false } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "query", "source", "as_of", "interpretation", "note", "filter", "sections", "result_count", "results", "summary", "model", "disclaimer" ], "properties": { "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "as_of": { "type": "string" }, "model": { "type": "string" }, "query": { "type": "string" }, "filter": { "type": "object", "required": [ "min_price", "max_price", "min_change_percent", "max_change_percent", "min_volume", "sort", "order", "limit", "signal" ], "properties": { "sort": { "type": "string" }, "limit": { "type": "number" }, "order": { "type": "string" }, "signal": { "type": "string" }, "max_price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "min_price": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "min_volume": { "anyOf": [ { "type": "number" }, { "type": "null" … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "note": null, "as_of": "2026-06-08T12:00:00.000Z", "model": "gpt-4o-mini", "query": "oversold large caps up today on high volume", "filter": { "sort": "change_percent", "limit": 10, "order": "desc", "signal": "oversold", "max_price": null, "min_price": 20, "min_volume": 5000000, "max_change_percent": null, "min_change_percent": 0 }, "source": "x402stock", "results": [ { "rsi": 28.4, "price": 71.2, "ticker": "PYPL", "volume": 14000000, "rationale": "Up 3.1% today on heavy volume while RSI at 28 flags it oversold.", "change_percent": 3.1 }, { "rsi": 26.9, "price": 22.6, "ticker": "INTC", "volume": 38000000, "rationale": "Bouncing 1.8% with very high volume from a deeply oversold RSI of 27.", "change_percent": 1.8 } ], "summary": "Two liquid large caps rebounding today from oversold conditions.", "sections": { "filter": "ok", "market": "ok", "rationale": "ok" }, "disclaimer": "AI-assisted screen over delayed whole-market data, not investment advice.", "result_count": 2, "interpretation": "Large, liquid stocks trading up today that are technically oversold (RSI < 30)." } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-smart-stock-screener-d57bf87d/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402stock.xyz](https://www.zero.xyz/host/x402stock.xyz/llms.txt)