# Polymarket Trader Leaderboard

> Polymarket Trader Leaderboard is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.012/call, status unknown (last checked 2026-10-18).

Returns ranked trader leaderboard data from Polymarket for a selected category and time period, ordered by PnL or volume.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/polymarket/v1/leaderboard?utm_source=zero.xyz
- Price: $0.012/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-trader-leaderboard-736879e1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uXvN_Hk9U1WxULkevZGbA

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 aisa-mpp-data-apis-polymarket-trader-leaderboard-736879e1
```

Example prompt: Who are the top 10 Polymarket traders by PnL in the crypto category over the past month?

## When to prefer this

Use this endpoint when you need ranked trader performance data specifically from Polymarket prediction markets, with support for filtering by market category (politics, crypto, sports, etc.), time period, and ordering by PnL or volume. Prefer this over general financial leaderboards when the user's question is specifically about prediction market traders.

## Known failure modes

- Invalid wallet address format (must be 0x-prefixed 40-char hex) returns a validation error
- Offset exceeding 1000 or limit exceeding 50 returns a parameter validation error
- Invalid enum values for category, timePeriod, or orderBy return a bad request error
- Username or wallet address not found returns an empty array
- Network or upstream Polymarket API outage returns a 5xx error

## How this service works

Returns trader leaderboard rankings for a selected category and time period.

<!-- aisa-pricing:start -->
Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

An array of trader objects, each containing rank position, username, X (Twitter) username, proxy wallet address, profit/loss amount, trading volume, profile image URL, and whether the trader has a verified badge.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "user": {
   "type": "string",
   "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
   "pattern": "^0x[a-fA-F0-9]{40}$",
   "description": "Limit leaderboard to a single user by address"
  },
  "limit": {
   "type": "integer",
   "default": 25,
   "maximum": 50,
   "minimum": 1,
   "description": "Max number of leaderboard traders to return"
  },
  "offset": {
   "type": "integer",
   "default": 0,
   "maximum": 1000,
   "minimum": 0,
   "description": "Starting index for pagination"
  },
  "orderBy": {
   "enum": [
    "PNL",
    "VOL"
   ],
   "type": "string",
   "default": "PNL",
   "description": "Leaderboard ordering criteria"
  },
  "category": {
   "enum": [
    "OVERALL",
    "POLITICS",
    "SPORTS",
    "ESPORTS",
    "CRYPTO",
    "CULTURE",
    "MENTIONS",
    "WEATHER",
    "ECONOMICS",
    "TECH",
    "FINANCE"
   ],
   "type": "string",
   "default": "OVERALL",
   "description": "Market category for the leaderboard"
  },
  "userName": {
   "type": "string",
   "description": "Limit leaderboard to a single username"
  },
  "timePeriod": {
   "enum": [
    "DAY",
    "WEEK",
    "MONTH",
    "ALL"
   ],
   "type": "string",
   "default": "DAY",
   "description": "Time period for leaderboard results"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object",
  "properties": {
   "pnl": {
    "type": "number",
    "description": "Profit and loss for this trader"
   },
   "vol": {
    "type": "number",
    "description": "Trading volume for this trader"
   },
   "rank": {
    "type": "string",
    "description": "The rank position of the trader"
   },
   "userName": {
    "type": "string",
    "description": "The trader's username"
   },
   "xUsername": {
    "type": "string",
    "description": "The trader's X (Twitter) username"
   },
   "proxyWallet": {
    "type": "string",
    "example": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "pattern": "^0x[a-fA-F0-9]{40}$",
    "description": "User Profile Address (0x-prefixed, 40 hex chars)"
   },
   "profileImage": {
    "type": "string",
    "description": "URL to the trader's profile image"
   },
   "verifiedBadge": {
    "type": "boolean",
    "description": "Whether the trader has a verified badge"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-trader-leaderboard-736879e1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)