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

# Leaderboard

> Top traders ranked by profit or volume.

Returns the top 20 Polymarket traders for the specified time period and ranking metric.

<ParamField query="period" type="string" default="monthly">
  Time period. One of: `daily`, `weekly`, `monthly`, `all`.
</ParamField>

<ParamField query="sort" type="string" default="profit">
  Ranking metric. One of: `profit`, `volume`.
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "traders": [
      {
        "rank": 1,
        "wallet": "0xc2e7800b5af46e6093872b177b7a5e7f0563be51",
        "name": "beachboy4",
        "pnl": 4320443.26,
        "volume": 12846475.79,
        "profileImage": "https://..."
      }
    ],
    "period": "monthly",
    "sort": "profit",
    "count": 20
  }
  ```
</ResponseExample>

<Note>
  Data refreshes every 2-3 minutes. Rate limit: 1 request per second.
</Note>


## OpenAPI

````yaml GET /v1/leaderboard
openapi: 3.1.0
info:
  title: PolyNode API
  description: >-
    Real-time Polymarket data API with decoded mempool settlements, OHLCV
    candles, and full Polygon JSON-RPC proxy.
  contact:
    name: PolyNode
    url: https://polynode.dev
  license:
    name: ''
  version: 2.0.0
servers:
  - url: https://api.polynode.dev
    description: Production
security:
  - api_key: []
paths:
  /v1/leaderboard:
    get:
      tags:
        - Enriched Data
      summary: Leaderboard
      description: >-
        Top 20 Polymarket traders ranked by profit or volume for a given time
        period.
      operationId: leaderboard
      parameters:
        - name: period
          in: query
          description: Time period
          schema:
            type: string
            enum:
              - daily
              - weekly
              - monthly
              - all
            default: monthly
        - name: sort
          in: query
          description: Ranking metric
          schema:
            type: string
            enum:
              - profit
              - volume
            default: profit
      responses:
        '200':
          description: Leaderboard results
          content:
            application/json:
              schema:
                type: object
                properties:
                  traders:
                    type: array
                    items:
                      type: object
                  period:
                    type: string
                  sort:
                    type: string
                  count:
                    type: integer
              example:
                traders:
                  - rank: 1
                    wallet: '0x02227b8f5a9636e895607edd3185ed6ee5598ff7'
                    name: HorizonSplendidView
                    pnl: 4016107.83
                    volume: 12394130.31
                    profileImage: >-
                      https://polymarket-upload.s3.us-east-2.amazonaws.com/fallback-image.png
                  - rank: 2
                    wallet: '0xc2e7800b5af46e6093872b177b7a5e7f0563be51'
                    name: beachboy4
                    pnl: 3762305.48
                    volume: 14130713.15
                    profileImage: >-
                      https://polymarket-upload.s3.us-east-2.amazonaws.com/fallback-image.png
                period: monthly
                sort: profit
                count: 20
        '401':
          description: Missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - api_key: []
components:
  schemas:
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: x-api-key

````