# x402stock US Stock Market Screener

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

Screen all US-listed stocks in a single call, filtering by price, percent change, and volume with sorting and limiting options.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/screener
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-7c495fc9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_--t_N9GbQ0e7-NaqBHBuD

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-xyz-7c495fc9
```

Example prompt: Screen the entire US stock market and show me the top 25 stocks sorted by percent change descending, with a minimum price of $5, minimum volume of 500000, and only those with at least 3% gain today.

## When to prefer this

Use this endpoint when you need to scan the entire US stock market universe in a single API call without iterating ticker by ticker. Ideal for agents building watchlists, identifying momentum setups, or surfacing unusual movers. Prefer over single-ticker endpoints when the goal is discovery rather than known-ticker lookup.

## Known failure modes

- Invalid sort field value returns error
- limit exceeding 500 may be rejected
- min_price greater than max_price yields empty results
- Payment not provided or insufficient USDC results in 402 Payment Required
- Missing required query params (sort, order, limit) may return validation error
- Stale or delayed data during off-market 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

Returns a JSON object containing metadata (source, as_of timestamp, universe size, matched count, sort, order, count) and a results array where each item includes ticker symbol, current price, change, change_percent, volume, and vwap — all filtered and sorted according to the query parameters.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "sort": "change_percent",
   "limit": 20,
   "order": "desc",
   "min_price": 10,
   "min_volume": 1000000
  }
 }
}
```

## 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": [
      "sort",
      "order",
      "limit"
     ],
     "properties": {
      "sort": {
       "enum": [
        "change_percent",
        "price",
        "volume"
       ],
       "type": "string",
       "default": "change_percent"
      },
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 500,
       "exclusiveMinimum": 0
      },
      "order": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "desc"
      },
      "max_price": {
       "type": "number",
       "minimum": 0
      },
      "min_price": {
       "type": "number",
       "minimum": 0
      },
      "min_volume": {
       "type": "number",
       "minimum": 0
      },
      "max_change_percent": {
       "type": "number"
      },
      "min_change_percent": {
       "type": "number"
      }
     },
     "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": [
      "source",
      "as_of",
      "universe",
      "matched",
      "sort",
      "order",
      "count",
      "results"
     ],
     "properties": {
      "sort": {
       "enum": [
        "change_percent",
        "price",
        "volume"
       ],
       "type": "string"
      },
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "order": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "matched": {
       "type": "number"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "ticker",
         "p
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "change_percent",
  "as_of": "2026-06-01T15:00:00.000Z",
  "count": 1,
  "order": "desc",
  "source": "x402stock",
  "matched": 87,
  "results": [
   {
    "vwap": 129.9,
    "price": 131.26,
    "change": 8.4,
    "ticker": "NVDA",
    "volume": 412000000,
    "change_percent": 6.83
   }
  ],
  "universe": 11342
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-xyz-7c495fc9/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)