# Arkham x402 Polymarket Leaderboard

> Arkham x402 Polymarket Leaderboard is a paid API for AI agents from api.arkm.com, paid per call via x402, $2/call, status unknown (last checked 2026-09-15).

Returns a ranked leaderboard of top Polymarket traders with PnL, trade counts, token stats, and market category breakdowns for a given time period.

## Facts

- Endpoint: POST https://api.arkm.com/x402/polymarket/leaderboard
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-polymarket-leaderboard-78bbc936
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BBfVZS6x2sBDx4nsmQgBh

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 arkham-x402-polymarket-leaderboard-78bbc936 -d '<json body>'
```

Example prompt: Pull the Polymarket leaderboard for the last 24 hours sorted descending by PnL — I want to see the top traders, their wallet addresses, profit figures, trade counts, and which market categories they're trading in.

## When to prefer this

Use this endpoint when you need ranked, on-chain Polymarket trader performance data enriched with wallet intelligence from Arkham — especially when you want PnL-sorted leaderboards with category breakdowns. Prefer this over raw on-chain queries when you need pre-aggregated stats across multiple market tags without building your own indexer.

## Known failure modes

- Invalid or missing sort/period parameters return an error response
- x402 payment failure if USDC balance is insufficient (endpoint requires $2 USDC per call)
- Empty leaderboard if no trading activity occurred in the specified period
- Rate limiting or authentication errors if API key is invalid
- Network timeout if Arkham backend is under load

## How this service works

Get Arkham Polymarket leaderboard. $2.00 per call.

## Output

A JSON object containing a sorted array of leaderboard entries, each with: rank, wallet address, period PnL (in USD), tokens won, total tokens, trade count, and an array of market category tags with label, event count, and volume for each category.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Max entries (1-200). Default: 100"
  },
  "order": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Sort order: desc (top traders) or asc (worst traders). Default: desc"
  },
  "offset": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Pagination offset. Default: 0"
  },
  "period": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Time period: 1d, 1w, 1m, all. Default: 1d"
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Optional trade address. If set, also returns this user's rank."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "desc",
  "period": "1d",
  "entries": [
   {
    "rank": 1,
    "tags": [
     {
      "tag": "baseball",
      "label": "Baseball",
      "events": 18648,
      "volume": "13142524.850084"
     },
     {
      "tag": "games",
      "label": "Games",
      "events": 18648,
      "volume": "13142524.850084"
     },
     {
      "tag": "mlb",
      "label": "Mlb",
      "events": 18648,
      "volume": "13142524.850084"
     }
    ],
    "periodPnl": "300749.583652",
    "tokensWon": 123,
    "tradeCount": 142,
    "tokensTotal": 238,
    "userAddress": "0x5e9458202b5817A72Cf81105EC8A30e6f3705ba1"
   },
   {
    "rank": 2,
    "tags": [
     {
      "tag": "games",
      "label": "Games",
      "events": 17425,
      "volume": "42549972.811718"
     },
     {
      "tag": "sports",
      "label": "Sports",
      "events": 17425,
      "volume": "42549972.811718"
     },
     {
      "tag": "baseball",
      "label": "Baseball",
      "events": 4135,
      "volume": "18799123.407022"
     }
    ],
    "periodPnl": "252263.11266239",
    "tokensWon": 241,
    "tradeCount": 20,
    "tokensTotal": 514,
    "userAddress": "0x4BFF30Af91642dc7d2b19A8664378Fe55C45Fc26"
   },
   {
    "rank": 3,
    "tags": [
     {
      "tag": "politics",
      "label": "Politics",
      "events": 4504,
      "volume": "5195284.291581"
     },
     {
      "tag": "fed",
      "label": "Fed",
      "events": 3764,
      "volume": "3576222.36051"
     },
     {
      "tag": "fed-rates",
      "label": "Fed Rates",
      "events": 3663,
      "volume": "3551694.256846"
     }
    ],
    "periodPnl": "189114.8628772455",
    "tokensWon": 748,
    "tradeCount": 104,
    "tokensTotal": 1227,
    "userAddress": "0x3A8aa345D5Db7ec5138298C8C4f4540259be7699"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-polymarket-leaderboard-78bbc936/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)