# Predge Whale Intelligence — Market Signals by Condition ID

> Predge Whale Intelligence — Market Signals by Condition ID is a paid API for AI agents from api.predge.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns real-time smart-money whale trading signals for a specific Polymarket prediction market, including net flow direction, confidence, and qualifying wallet metrics.

## Facts

- Endpoint: GET https://api.predge.io/v1/signals/market/%7BconditionId%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-whale-intelligence-market-signals-by-condition-id-96db48c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MenttD9XejE0oG5pmBB3B

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-intelligence-market-signals-by-condition-id-96db48c5
```

Example prompt: Check Predge for whale signals on the Polymarket market with condition ID 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — tell me which direction smart money is leaning and how confident the signal is.

## When to prefer this

Use this endpoint when you need quantitative smart-money intelligence for a specific Polymarket prediction market identified by its condition ID. It is purpose-built for whale flow analysis with statistically validated wallet scoring (Wilson-95% lower bound on realized edge), making it superior to generic on-chain analytics or raw order book data when you want a pre-computed directional signal with confidence grading.

## Known failure modes

- Invalid or unknown conditionId returns an error or empty result
- Market not tracked on Polymarket returns no data
- Insufficient trading activity sets insufficient_data: true and may return no directional signal
- Network or rate-limit errors from the API
- Payment not provided or rejected (x402 payment required error)

## 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

Returns a JSON object containing: a human-readable basis summary, market metadata (title, status, category, yes/no price, resolution), a directional signal (YES/NO), confidence level (high/medium/low), smart money definition parameters, net flow in USD, smart wallet count, smart and total whale volume breakdown over the specified window, and a flag indicating whether data was insufficient.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "basis": "6 edge-proven smart-money wallet(s) moved $143,000 net toward YES (82% of $225,000 smart volume) on this market in the last 24h.",
  "market": {
   "title": "Will the Fed cut rates in September?",
   "status": "active",
   "category": "economics",
   "platform": "polymarket",
   "yes_price": 0.62,
   "resolution": null,
   "resolved_at": null,
   "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39"
  },
  "direction": "yes",
  "confidence": "high",
  "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
  },
  "net_flow_usd": 143000,
  "smart_no_usd": 41000,
  "window_hours": 24,
  "smart_wallets": 6,
  "smart_yes_usd": 184000,
  "insufficient_data": false,
  "smart_whale_volume_usd": 225000,
  "total_whale_volume_usd": 412000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-whale-intelligence-market-signals-by-condition-id-96db48c5/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)