> ## 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.

# Get trader leaderboard rankings

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



## OpenAPI

````yaml openapi/polymarket-data.json GET /apis/v1/polymarket/v1/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: feb7e7e799d9177ec0f8882f97e02989b98ffb3fbe1ccec4889e76a0a2aa653d
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:74a76870f8ab0c802f330a8dabec1556aae0a5e3ff3735553eb70c60d5871dbd
  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: feb7e7e799d9177ec0f8882f97e02989b98ffb3fbe1ccec4889e76a0a2aa653d
        generator_version: '2'
        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/leaderboard:
    get:
      tags:
        - default
      summary: Get trader leaderboard rankings
      description: >-
        Returns trader leaderboard rankings for a selected category and time
        period.
      operationId: any_polymarket_data_apis_v1_polymarket_v1_leaderboard
      parameters:
        - in: query
          name: category
          schema:
            type: string
            enum:
              - OVERALL
              - POLITICS
              - SPORTS
              - ESPORTS
              - CRYPTO
              - CULTURE
              - MENTIONS
              - WEATHER
              - ECONOMICS
              - TECH
              - FINANCE
            default: OVERALL
          description: Market category for the leaderboard
        - in: query
          name: limit
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 50
          description: Max number of leaderboard traders to return
        - in: query
          name: offset
          schema:
            type: integer
            default: 0
            minimum: 0
            maximum: 1000
          description: Starting index for pagination
        - in: query
          name: orderBy
          schema:
            type: string
            enum:
              - PNL
              - VOL
            default: PNL
          description: Leaderboard ordering criteria
        - in: query
          name: timePeriod
          schema:
            type: string
            enum:
              - DAY
              - WEEK
              - MONTH
              - ALL
            default: DAY
          description: Time period for leaderboard results
        - in: query
          name: user
          schema:
            type: string
            description: User Profile Address (0x-prefixed, 40 hex chars)
            pattern: ^0x[a-fA-F0-9]{40}$
            example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
          description: Limit leaderboard to a single user by address
        - in: query
          name: userName
          schema:
            type: string
          description: Limit leaderboard to a single username
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: >-
                    #/components/schemas/Response65D835437A58_TraderLeaderboardEntry
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response65D835437A58_TraderLeaderboardEntry:
      type: object
      properties:
        rank:
          type: string
          description: The rank position of the trader
        proxyWallet:
          $ref: '#/components/schemas/Response65D835437A58_Address'
        userName:
          type: string
          description: The trader's username
        vol:
          type: number
          description: Trading volume for this trader
        pnl:
          type: number
          description: Profit and loss for this trader
        profileImage:
          type: string
          description: URL to the trader's profile image
        xUsername:
          type: string
          description: The trader's X (Twitter) username
        verifiedBadge:
          type: boolean
          description: Whether the trader has a verified badge
    Response65D835437A58_Address:
      type: string
      description: User Profile Address (0x-prefixed, 40 hex chars)
      pattern: ^0x[a-fA-F0-9]{40}$
      example: '0x56687bf447db6ffa42ffe2204a05edaa20f55839'
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

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