# Polymarket Builder Leaderboard

> Polymarket Builder 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 leaderboard of Polymarket builders by trading volume and active users over a specified time period.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/polymarket/v1/builders/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-builder-leaderboard-c36fe92c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EnFAqCOfbg8pLTOdFDLu_

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-builder-leaderboard-c36fe92c
```

Example prompt: Show me the top 25 Polymarket builders by trading volume for this week — I want to see their ranks, volumes, and whether they're verified.

## When to prefer this

Use this endpoint when you need ranked leaderboard data specifically for Polymarket builders, including volume metrics, active user counts, and verification status, with flexible time-period filtering (day/week/month/all-time) and pagination support. Prefer this over generic Polymarket data endpoints when the specific use case is competitive builder rankings.

## Known failure modes

- Invalid timePeriod enum value returns 400 error
- limit exceeding 50 or offset exceeding 1000 returns validation error
- Polymarket data source temporarily unavailable causing 503
- Empty array returned if no builder activity exists for the selected period

## How this service works

Returns aggregated builder leaderboard rankings.

<!-- 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 builder objects each containing rank position, builder name/identifier, total trading volume, active user count, verification status, onchain builder code, and logo URL — sorted by rank for the requested time period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 25,
   "maximum": 50,
   "minimum": 0,
   "description": "Maximum number of builders to return"
  },
  "offset": {
   "type": "integer",
   "default": 0,
   "maximum": 1000,
   "minimum": 0,
   "description": "Starting index for pagination"
  },
  "timePeriod": {
   "enum": [
    "DAY",
    "WEEK",
    "MONTH",
    "ALL"
   ],
   "type": "string",
   "default": "DAY",
   "description": "The time period to aggregate results over.\n"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object",
  "properties": {
   "rank": {
    "type": "string",
    "description": "The rank position of the builder"
   },
   "volume": {
    "type": "number",
    "description": "Total trading volume attributed to this builder"
   },
   "builder": {
    "type": "string",
    "description": "The builder name or identifier"
   },
   "verified": {
    "type": "boolean",
    "description": "Whether the builder is verified"
   },
   "activeUsers": {
    "type": "integer",
    "description": "Number of active users for this builder"
   },
   "builderCode": {
    "type": "string",
    "description": "The builder's onchain attribution code as attached to orders via `builderCode` (see CLOB V2). Empty string for legacy builders without a registered code."
   },
   "builderLogo": {
    "type": "string",
    "description": "URL to the builder's logo image"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-polymarket-builder-leaderboard-c36fe92c/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)