# Polymarket Leaderboard

> Polymarket Leaderboard is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns top Polymarket traders ranked by realized profit or notional volume over configurable time windows (1d/1w/1m/all-time)

## Facts

- Endpoint: POST https://x402.agentutility.ai/polymarket-leaderboard
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-leaderboard-92cfe79e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iBRhh3_sOSnHNPEIwKejT

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-leaderboard-92cfe79e -d '<json body>'
```

Example prompt: Pull the Polymarket profit leaderboard for the past week and show me the top 20 traders with their pseudonyms, wallet addresses, and realized P&L in USD.

## When to prefer this

Use this endpoint when you need structured, ranked Polymarket trader data with profile details (pseudonym, bio, wallet) and USD amounts. Prefer this over scraping Polymarket directly or using generic web search when you need clean, machine-readable leaderboard data for a specific time window and metric.

## Known failure modes

- Invalid time window value returns an error
- Invalid ranking metric (not profit or volume) returns an error
- Network or upstream Polymarket data unavailability may return a 5xx error
- Payment failure (insufficient USDC balance) blocks the request

## How this service works

Polymarket leaderboard / top traders / profit leaderboard / Polymarket whales / volume leaderboard / prediction market rankings. Returns the top accounts by realized profit OR notional volume over 1d/1w/1m/all-time windows. Includes proxy wallet, pseudonym, bio, amount in USD. DATA only.

## Output

A ranked list of top Polymarket accounts including each trader's proxy wallet address, pseudonym, bio, and either realized profit or notional volume in USD, filtered by the requested time window and metric.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "metric": "profit",
  "window": "1d",
  "attribution": "Data: Polymarket lb-api. https://polymarket.com/leaderboard",
  "leaderboard": [
   {
    "rank": 1,
    "wallet": "0x91eee6b7...",
    "pseudonym": "everydaymortgage",
    "amount_usd": 1296360.86
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-leaderboard-92cfe79e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)