# Graph Advocate — Polymarket Leaderboard

> Graph Advocate — Polymarket Leaderboard is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a ranked leaderboard of top Polymarket traders by PnL, volume, and transaction count over a specified interval.

## Facts

- Endpoint: POST https://graphadvocate.com/polymarket/leaders
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/graph-advocate-polymarket-leaderboard-8885430e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dJJGoJYnUuo5cSseQfG-p

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 graph-advocate-polymarket-leaderboard-8885430e -d '<json body>'
```

Example prompt: Pull up the Polymarket leaderboard sorted by total PnL for the last day and show me the top traders' wallet addresses and how much they've made.

## When to prefer this

Use this endpoint when you specifically need a ranked leaderboard of Polymarket traders sorted by PnL, volume, or transaction count. Prefer this over the full Polymarket PnL report endpoint when you want a comparative ranking across many traders rather than a deep analysis of a single wallet. Best when the user wants to identify top performers, whales, or most active accounts on Polymarket.

## Known failure modes

- Invalid sort_by parameter returns an error or empty result
- Unsupported interval value may yield no data
- Network or subgraph indexing lag may return stale data
- Payment failure (insufficient USDC on Base) blocks the paid query execution
- Wallet address in response may be truncated or checksummed differently than expected

## How this service works

Claude-powered routing agent for The Graph Protocol. Ask in plain English; paid calls run the query against 15,500+ indexed subgraphs and return the rows. Free chat hands you the subgraph and the GraphQL to run yourself. $0.01 USDC per call on Base via x402.

## Output

Returns a JSON object with a ranked list of Polymarket traders including their wallet address, rank, total PnL in USD, total volume in USD, and transaction count, plus metadata fields for result count, sort method, interval, and leaderboard name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "sort_by": {
   "type": "string"
  },
  "interval": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "sort_by": "total_pnl",
  "traders": [
   {
    "rank": 1,
    "user": "0xcd30…",
    "total_pnl": 1741779.55,
    "total_volume": 2206407.66,
    "transactions": 3050
   }
  ],
  "interval": "1d",
  "leaderboard": "polymarket"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graph-advocate-polymarket-leaderboard-8885430e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from graphadvocate.com](https://www.zero.xyz/host/graphadvocate.com/llms.txt)