# News Gurus Whale Leaders Prediction API

> News Gurus Whale Leaders Prediction API is a paid API for AI agents from api.newsgurus.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Returns ranked list of top-performing prediction market wallets ('whale leaders') sorted by informed score, win rate, total PnL, or volume

## Facts

- Endpoint: GET https://api.newsgurus.ai/x402/prediction/whale-leaders
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/news-gurus-whale-leaders-prediction-api-2e730704
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JTG3p-_BPM8Zww4fbrDFW

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-whale-leaders-prediction-api-2e730704
```

Example prompt: Show me the top 10 whale leaders on News Gurus ranked by informed score, with at least 5 bets placed.

## When to prefer this

Use this endpoint when you need to identify the most consistently profitable or informed prediction market participants ranked by quantitative metrics. Prefer this over general market data APIs when you specifically want on-chain wallet performance in prediction markets, especially for copy-trading research, leaderboard displays, or signal generation based on smart-money activity.

## Known failure modes

- Invalid sort_by value returns 400 error
- limit exceeding 50 returns validation error
- min_bets below 0 returns validation error
- Payment failure (x402) if USDC balance insufficient
- Empty wallet list if no wallets meet min_bets threshold
- Stale data if underlying data pipeline is delayed

## How this service works

News Gurus Intel API — Polymarket smart-money leaderboard: whale wallets ranked by informed score, win rate, realized PnL or volume, with specialization and average entry odds. Insider/algo detection per-call — elsewhere this data class sits behind $599/mo API plans. Educational data, not financial advice.

## Output

A JSON object containing a list of wallet records (up to the requested limit) each with address, win rate, total bets, informed score, specialization tag (e.g. 'politics'), and total PnL in USDC — plus the sort method used and a fetch timestamp.

## 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": 20,
       "maximum": 50,
       "minimum": 1
      },
      "sort_by": {
       "enum": [
        "informed_score",
        "win_rate",
        "total_pnl_usdc",
        "total_volume"
       ],
       "type": "string",
       "default": "informed_score"
      },
      "min_bets": {
       "type": "integer",
       "default": 5,
       "minimum": 0
      }
     },
     "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,
  "sort_by": "informed_score",
  "wallets": [
   {
    "address": "0xabc...",
    "win_rate": 0.71,
    "total_bets": 96,
    "informed_score": 0.82,
    "specialization": "politics",
    "total_pnl_usdc": 184220.5
   }
  ],
  "fetched_at": "2026-07-15T14:00:00+00:00"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/news-gurus-whale-leaders-prediction-api-2e730704/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)