# Polymarket Builder Leaderboard

> Polymarket Builder Leaderboard is a paid API for AI agents from api.seerium.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns a ranked leaderboard of Polymarket prediction market creators, sorted by volume, active users, and verification status across configurable time periods.

## Facts

- Endpoint: GET https://api.seerium.xyz/v1/prediction/builders
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-seerium-xyz-f9400cd7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sD-BSpOPokbFvvFZFH8iE

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 api-seerium-xyz-f9400cd7
```

Example prompt: Show me the top 20 Polymarket builders for this week, ranked by volume and active users.

## When to prefer this

Use this endpoint when an agent needs to identify, rank, or compare Polymarket prediction market creators by activity, volume, or verification. Ideal for competitive analysis of builder performance, identifying top creators for follow-up research, or surfacing trending market makers over specific time horizons.

## Known failure modes

- Invalid timePeriod enum value returns validation error
- limit or offset out of range returns 400
- No builders found for period returns empty list
- Payment not attached or insufficient balance returns 402
- Service unavailable or Polymarket data lag returns 503

## How this service works

Polymarket API for builder stats. Ranks prediction market creators by volume, active users, verification, and period comparisons.

## Output

A paginated ranked list of Polymarket market builders with metrics including trading volume, active user counts, verification status, and period-over-period comparisons.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 20,
   "offset": 0,
   "timePeriod": "WEEK"
  }
 }
}
```

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "number",
       "minimum": 1,
       "description": "Optional maximum ranked Polymarket builders to return. Defaults to 50."
      },
      "offset": {
       "type": "number",
       "minimum": 0,
       "description": "Optional pagination offset. Defaults to 0."
      },
      "timePeriod": {
       "enum": [
        "DAY",
        "WEEK",
        "MONTH",
        "ALL"
       ],
       "type": "string",
       "description": "Optional Polymarket builder ranking period. Defaults to MONTH."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "total": 24,
   "summary": {
    "period": "MONTH",
    "topBuilder": "Example Builder",
    "activeUsers": 1800,
    "totalVolume": 4200000,
    "builderCount": 24,
    "verifiedCount": 12,
    "topBuilderShare": 0.2976,
    "topBuilderVolume": 1250000,
    "medianVolumePerUser": 1800
   },
   "builders": [
    {
     "dt": "2026-03-25T00:00:00.000Z",
     "rank": 1,
     "volume": 1250000,
     "builder": "Example Builder",
     "verified": true,
     "activeUsers": 420,
     "builderLogo": null,
     "volumeShare": 0.2976,
     "volumePerActiveUser": 2976.19
    }
   ],
   "criteria": {
    "limit": 25,
    "offset": 0,
    "timePeriod": "MONTH"
   },
   "updatedAt": "2026-03-25T11:59:30.000Z",
   "nextOffset": null
  },
  "meta": {
   "requestId": "req_example_123",
   "updatedAt": "2026-03-25T11:59:30.000Z",
   "freshnessMs": 30000,
   "generatedAt": "2026-03-25T12:00:00.000Z"
  },
  "product": {
   "id": "polymarket-builder-stats",
   "name": "Polymarket Builder Stats API",
   "path": "/v1/prediction/builders",
   "price": "$0.1000",
   "method": "GET",
   "accepts": [
    {
     "payTo": "0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5",
     "price": "$0.1000",
     "scheme": "exact",
     "network": "eip155:8453"
    },
    {
     "payTo": "2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ",
     "price": "$0.1000",
     "scheme": "exact",
     "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
    }
   ],
   "networks": [
    "eip155:8453",
    "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
   ]
  },
  "service": "seerium-x402-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-seerium-xyz-f9400cd7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.seerium.xyz](https://www.zero.xyz/host/api.seerium.xyz/llms.txt)