# Predge Signals Consensus by Category

> Predge Signals Consensus by Category 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-15).

Returns smart-money consensus signals for Polymarket prediction markets filtered by category, showing net flow, smart wallet direction, and current prices.

## Facts

- Endpoint: GET https://api.predge.io/v1/signals/consensus/%7Bcategory%7D
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-signals-consensus-by-category-65df4352
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DLVTtYJA1YoOzpWfM-34i

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-signals-consensus-by-category-65df4352
```

Example prompt: Pull the Predge smart-money consensus signals for the economics category on Polymarket — I want to see where whale wallets are flowing and what direction they're betting.

## When to prefer this

Use this endpoint when you need real-time, category-level smart-money consensus from Polymarket — specifically when you want to identify where statistically edge-verified whale wallets are placing directional bets. Prefer this over generic Polymarket APIs when wallet quality scoring (Wilson lower-bound edge) and net flow aggregation by smart wallets matter. Best for trading signal research, market monitoring, and identifying informed trader activity within a specific domain category.

## Known failure modes

- Unknown or unsupported category returns empty markets array or 404
- Category with no recent smart-wallet activity returns markets list with zero net flow values
- insufficient_data flag set to true if not enough resolved trades exist to score wallets
- Rate limiting or payment failure returns 402 if USDC payment not provided
- Fresh markets may be miscategorized or excluded until ingest catches up

## How this service works

Real-time alerts on whale traders on Polymarket. Heuristic Insider Watch, wallet scoring 0–100, Bloomberg-style web terminal. Free plan included.

## Output

A JSON array of Polymarket markets in the requested category, each with title, platform, condition ID, yes/no direction, net flow in USD, smart-wallet yes and no USD totals, smart wallet count, and current yes price. Also includes smart money methodology metadata (edge window, qualifying wallets, minimum edge), window hours, and a coverage note about partial category coverage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "markets": [
   {
    "title": "Will the Fed cut rates in September?",
    "category": "economics",
    "platform": "polymarket",
    "direction": "yes",
    "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39",
    "net_flow_usd": 143000,
    "smart_no_usd": 41000,
    "smart_wallets": 6,
    "smart_yes_usd": 184000,
    "market_yes_price": 0.62
   }
  ],
  "category": "economics",
  "smart_money": {
   "basis": "edge_lower_bound",
   "definition": "smart money = a wallet whose luck-damped realized edge over the trailing window is positive (Wilson-95%-lower-bound(win rate) − avg entry price > min_edge_lower_bound), from RESOLVED outcomes — not the opaque scorer score",
   "min_trades": 10,
   "min_volume_usd": 1000,
   "edge_window_days": 30,
   "qualifying_wallets": 474,
   "min_edge_lower_bound": 0
  },
  "window_hours": 24,
  "coverage_note": "category coverage is partial: markets without a category (historical tag-less tail) are excluded from category slices; fresh markets are categorized on ingest",
  "insufficient_data": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-signals-consensus-by-category-65df4352/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)