# News Gurus Volatility Scanner

> News Gurus Volatility Scanner is a paid API for AI agents from api.newsgurus.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns a ranked list of assets by composite volatility score, including ATR percentage, volume, and galaxy score, filtered optionally by asset class.

## Facts

- Endpoint: GET https://api.newsgurus.ai/x402/volatility/scan
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/news-gurus-volatility-scanner-f4de0383
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ICWHa5qJZX4j4ozm-Ojii

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 news-gurus-volatility-scanner-f4de0383
```

Example prompt: Pull the top 10 most volatile crypto assets right now from News Gurus — I want their ATR, volume, and composite scores ranked.

## When to prefer this

Choose this endpoint when you need a real-time ranked list of the most volatile assets across crypto or equities, with composite scoring that blends ATR, volume, and proprietary galaxy score. Prefer it over raw market data APIs when you want pre-ranked, actionable volatility signals rather than raw OHLCV data you'd have to compute yourself.

## Known failure modes

- Invalid asset_class value returns empty results or 400 error
- limit out of range (>50 or <1) returns validation error
- Payment failure (x402) blocks access if USDC balance is insufficient
- Stale data if underlying scan agents are delayed
- No results returned if no assets meet scan criteria at that moment

## How this service works

40+ AI agents scanning dark pools, congressional trades, options flow, and breaking news 24/7. Clear, actionable signals for busy owners and everyday workers — plus a keyless pay-per-call x402 API for AI agents.

## Output

A JSON array of ranked assets each containing: symbol, asset class, ATR percentage, USD volume, galaxy score, composite score, rank, and the timestamp of the scan — sorted by composite volatility score descending, up to the requested limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 50,
       "minimum": 1
      },
      "asset_class": {
       "type": "string",
       "description": "Optional asset class filter, e.g. crypto or equity"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 1,
  "scores": [
   {
    "rank": 1,
    "symbol": "BTC",
    "atr_pct": 4.2,
    "scan_time": "2026-07-17T13:00:00",
    "volume_usd": 8100000,
    "asset_class": "crypto",
    "galaxy_score": 72.5,
    "composite_score": 0.88
   }
  ],
  "fetched_at": "2026-07-17T14:05:00+00:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/news-gurus-volatility-scanner-f4de0383/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.newsgurus.ai](https://www.zero.xyz/host/api.newsgurus.ai/llms.txt)