# Polymarket Top Traders Leaderboard

> Polymarket Top Traders Leaderboard is a paid API for AI agents from bess-x402.onrender.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-29).

Returns Polymarket's top traders ranked by profit or volume for a given time period, optionally filtered by category, with wallet addresses.

## Facts

- Endpoint: GET https://bess-x402.onrender.com/v1/predictions/polymarket/leaderboard?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-top-traders-leaderboard-9654f7d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4QFd9CT2njAW4ZWeOE4uh

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 polymarket-top-traders-leaderboard-9654f7d9
```

Example prompt: Pull the top 10 Polymarket traders ranked by PnL for this week in the politics category — I want their wallet addresses so I can follow them.

## When to prefer this

Use this endpoint when you need to discover or monitor top-performing Polymarket prediction market traders, obtain wallet addresses for copy-trading or analytics, or analyze who is dominating a specific category or time window. Prefer this over generic blockchain analytics tools when the specific context is Polymarket leaderboard data with category and period filtering.

## Known failure modes

- Invalid period value (must be day, week, month, or all)
- Invalid order_by value (must be pnl or volume)
- Unknown or misspelled category returns empty results
- Limit out of range (must be 1-50)
- Polymarket upstream API unavailable causing 502/503
- No traders found for a very specific category/period combination

## How this service works

Polymarket's top traders by profit or volume for the day, week, month or all time, optionally in one category (politics, sports, crypto...), with wallet addresses to follow.

## Output

A ranked list of top Polymarket traders including wallet addresses, profit/loss figures, trading volume, and leaderboard position — filtered by the requested time period (day/week/month/all), ranking metric (pnl or volume), and optionally by category (e.g. politics, sports, crypto).

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Rows (1-50)"
      },
      "period": {
       "type": "string",
       "description": "day, week, month or all"
      },
      "category": {
       "type": "string",
       "description": "Category, e.g. politics, sports, crypto"
      },
      "order_by": {
       "type": "string",
       "description": "pnl or volume"
      }
     }
    }
   },
   "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/polymarket-top-traders-leaderboard-9654f7d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bess-x402.onrender.com](https://www.zero.xyz/host/bess-x402.onrender.com/llms.txt)