# Predge Whale Data — Category Consensus

> Predge Whale Data — Category Consensus is a paid API for AI agents from api.predge.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-16).

Returns smart-money consensus signals (YES/NO volume, net flow, direction verdict) for active Polymarket prediction markets in a specified category, filtered to whale trades ≥$10,000 from edge-positive wallets in the last 24h.

## Facts

- Endpoint: GET https://api.predge.io/v1/signals/consensus/:category
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-whale-data-category-consensus-e8758984
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oE4UitB_jTvHBQvoGSW-y

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 predge-whale-data-category-consensus-e8758984
```

Example prompt: What's the smart-money whale consensus on Predge for the politics category right now — are edge-positive whales leaning YES or NO, and what's the net flow?

## When to prefer this

Use this endpoint when you need category-scoped smart-money signals from Polymarket specifically — i.e. you want to know what edge-proven whale wallets are doing in a named market vertical (politics, economics, sports, etc.) rather than across all markets. Prefer this over the global consensus endpoint when you need to narrow your analysis to one domain. Best for agents building sector-specific trading signals or monitoring a particular prediction market category for whale conviction.

## Known failure modes

- Unknown category name returns 404 with known_categories list (no charge)
- Insufficient whale activity in category returns {"insufficient_data": true, "reason": ...}
- Markets without assigned categories are excluded, reducing coverage
- 15-minute data delay may miss very recent whale trades
- Partial category coverage means some active markets may not appear

## How this service works

Smart-money consensus for ONE market category (path param, e.g. economics, politics, sports — case-insensitive). Same EDGE-based smart-money definition as /v1/signals/consensus (luck-damped realized edge over the last 30d > 0, NOT the scorer score), scoped: active Polymarket markets of that category with whale trades (>= $10,000) in the last 24h from edge-positive wallets; YES/NO smart volume, net flow, direction verdict. Category coverage is partial — markets without a category are excluded (see coverage_note in the response). Unknown category => 404 (not charged) listing known_categories. Honest degradation via {"insufficient_data": true, "reason": ...}. 15 min delay.

## Output

Returns per-market smart-money data for the requested category: YES and NO smart volume from whale trades ≥$10,000 by edge-positive wallets (luck-damped realized edge >0 over 30d), net flow, and an overall direction verdict. Includes a coverage_note about partial category coverage. If data is insufficient, returns {"insufficient_data": true, "reason": ...}. If the category is unknown, returns a 404 with a known_categories list (not charged). Data has a 15-minute delay.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-whale-data-category-consensus-e8758984/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.predge.io](https://www.zero.xyz/host/api.predge.io/llms.txt)