> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> ## Agent Instructions (AIsa)
>
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Paid calls need approval first. Docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP discovery are free to read. Before any paid, dynamically priced, or high-cost call, state the exact scope, rate, and maximum USD exposure, then wait for a separate user message approving that scope and cap. A request to collect data is not approval; do not send unapproved probes. Full rule: https://aisa.one/docs/llms.txt

# Get aggregated builder leaderboard

> Returns aggregated builder leaderboard rankings.

## Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

* **Default request reference estimate (USD):** 0.012
* **Cost contract:** fixed\_success
* **Settlement evidence source:** request\_snapshot


## OpenAPI

````yaml openapi/polymarket-data.json GET /apis/v1/polymarket/v1/builders/leaderboard
openapi: 3.1.0
info:
  description: ''
  title: Polymarket Data
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/polymarket/activity
    - /apis/v1/polymarket/closed-positions
    - /apis/v1/polymarket/holders
    - /apis/v1/polymarket/live-volume
    - /apis/v1/polymarket/oi
    - /apis/v1/polymarket/positions
    - /apis/v1/polymarket/traded
    - /apis/v1/polymarket/v1/accounting/snapshot
    - /apis/v1/polymarket/v1/builders/leaderboard
    - /apis/v1/polymarket/v1/builders/volume
    - /apis/v1/polymarket/v1/leaderboard
    - /apis/v1/polymarket/v1/market-positions
    - /apis/v1/polymarket/value
  x-aisa-document:
    facts_hash: e5ff56471e62e340c326a9cf8efdb405dd827483c23e3fee435eec7999b7a85a
    generator_version: '3'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '18'
    response_pending: []
    document_hash: sha256:c7127bf6b5b06dcb2cca0b01d0dfb6ae2910f025b5d3b720084efa83bff0bd96
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: polymarket-data
  x-aisa-catalogs:
    polymarket-data:
      title: Polymarket Data
      description: ''
      x-aisa-document:
        facts_hash: e5ff56471e62e340c326a9cf8efdb405dd827483c23e3fee435eec7999b7a85a
        generator_version: '3'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/polymarket/v1/builders/leaderboard:
    get:
      tags:
        - default
      summary: Get aggregated builder leaderboard
      description: Returns aggregated builder leaderboard rankings.
      operationId: any_polymarket_data_apis_v1_polymarket_v1_builder_e3d670
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
            default: 25
            minimum: 0
            maximum: 50
          description: Maximum number of builders to return
        - in: query
          name: offset
          schema:
            type: integer
            default: 0
            minimum: 0
            maximum: 1000
          description: Starting index for pagination
        - in: query
          name: timePeriod
          schema:
            type: string
            enum:
              - DAY
              - WEEK
              - MONTH
              - ALL
            default: DAY
          description: |
            The time period to aggregate results over.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Response65D835437A58_LeaderboardEntry'
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response65D835437A58_LeaderboardEntry:
      type: object
      properties:
        rank:
          type: string
          description: The rank position of the builder
        builder:
          type: string
          description: The builder name or identifier
        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.
        volume:
          type: number
          description: Total trading volume attributed to this builder
        activeUsers:
          type: integer
          description: Number of active users for this builder
        verified:
          type: boolean
          description: Whether the builder is verified
        builderLogo:
          type: string
          description: URL to the builder's logo image
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.