# Predge Whale Intelligence — Market Activity by Condition ID

> Predge Whale Intelligence — Market Activity 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 whale trader activity, wallet scores, trade history, and volume summary for a specific Polymarket prediction market over the last 7 days

## Facts

- Endpoint: GET https://api.predge.io/v1/whales/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-activity-by-condition-id-058312af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XycMfkdaQnrbZrOQtcBi6

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-activity-by-condition-id-058312af
```

Example prompt: Pull up whale trading activity on the Polymarket market with condition ID 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — I want to see which big wallets are buying YES or NO, their wallet scores, and the overall volume breakdown.

## When to prefer this

Use this endpoint when you need on-chain whale intelligence specifically for a known Polymarket market (by condition ID), including wallet scoring, win-rate attribution, and volume breakdowns. Prefer this over generic Polymarket APIs when you need heuristic insider detection, wallet reputation scoring, or smart-money flow signals rather than raw trade data.

## Known failure modes

- Invalid or malformed conditionId returns 400 or empty result
- Condition ID references a market not tracked by Predge returns empty trades array
- Payment not attached or insufficient USDC returns 402 Payment Required
- Rate limiting on free plan returns 429 Too Many Requests
- Market is resolved/closed but data may still be returned with status 'resolved'

## 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: the market title, status, category, and current YES price; an array of whale trades (wallet address, side, price, size in USD, wallet score 0–100, 30-day win rate, and block timestamp); and a summary of net flow in USD, total whale volume, YES/NO volume breakdown, and unique whale wallet count over the last 7 days.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "market": {
   "title": "Will the Fed cut rates in September?",
   "status": "active",
   "category": "economics",
   "platform": "polymarket",
   "yes_price": 0.62,
   "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39"
  },
  "trades": [
   {
    "side": "yes",
    "price": 0.62,
    "wallet": "0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8",
    "tx_hash": "0x6a7de5…",
    "category": "economics",
    "platform": "polymarket",
    "size_usd": 25400,
    "market_slug": "fed-rate-cut-september",
    "condition_id": "0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39",
    "market_title": "Will the Fed cut rates in September?",
    "wallet_score": 81,
    "block_timestamp": "2026-07-17T09:41:02.000Z",
    "wallet_win_rate_30d": 0.67
   }
  ],
  "summary": {
   "net_flow_usd": 168000,
   "whale_trades": 14,
   "no_volume_usd": 122000,
   "unique_wallets": 9,
   "yes_volume_usd": 290000,
   "whale_volume_usd": 412000
  },
  "window_days": 7
 }
}
```

## More

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