# Predge Wallet Leaderboard

> Predge Wallet Leaderboard 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-14).

Returns a ranked leaderboard of top-performing whale wallets on Polymarket, scored by conviction, edge, and win rate over a configurable time window.

## Facts

- Endpoint: GET https://api.predge.io/v1/wallets/leaderboard
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/predge-wallet-leaderboard-2c79a57e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c3CQXnJbcGl3I6g2Th99L

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-wallet-leaderboard-2c79a57e
```

Example prompt: Pull the Predge leaderboard of top Polymarket whale wallets for the last 30 days — give me the top 20 ranked by conviction score.

## When to prefer this

Choose this endpoint when you need a ranked list of the best-performing Polymarket wallets by quantitative metrics (edge, conviction, win rate) rather than data about a specific wallet. Ideal for copy-trading discovery, smart money surveillance, or building a watchlist of high-conviction Polymarket traders. Prefer this over individual wallet lookup endpoints when you want a broad leaderboard view rather than per-wallet detail.

## Known failure modes

- Invalid window value (not '7d' or '30d') returns a 400 error
- Limit out of range (outside 1–100) returns a 400 validation error
- Payment not processed returns a 402 Payment Required response
- Service unavailable or Polymarket data lag may return a 503 or stale data
- No wallets meeting minimum thresholds returns an empty list with insufficient_data: true

## 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 with the ranking window, a list of up to 100 wallet objects each containing: wallet address, edge score, lower-bound edge, win rate, lower-bound win rate, conviction score, trade count, decided trades, average entry price, average position size in USD, and total volume in USD. Also includes metadata such as minimum trade and volume thresholds applied, ranking method, and whether data was insufficient.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "window": "30d",
  "wallets": [
   {
    "edge": 0.37,
    "score": 81,
    "address": "0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8",
    "win_rate": 0.71,
    "trades_count": 24,
    "decided_trades": 17,
    "avg_entry_price": 0.34,
    "avg_position_usd": 17166.67,
    "conviction_score": 2.33,
    "edge_lower_bound": 0.18,
    "total_volume_usd": 412000,
    "win_rate_lower_bound": 0.52
   }
  ],
  "ranked_by": "conviction_score",
  "min_trades": 10,
  "min_volume_usd": 1000,
  "insufficient_data": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/predge-wallet-leaderboard-2c79a57e/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)