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

# Get leaderboard

> Top 100 wallets by points for a season, with the multiplier schedule.

Returns the top 100 wallets by `totalPoints` for the season, ranked from 1, plus the season's multiplier schedule. `totalParticipants` counts every wallet with points in the season, not only the 100 returned.

`dailyRate` on each entry is the points that wallet earned on `asOf`. `asOf` is the last closed New York day in the points tables, or `null` when the season has no data. Season 1 is a static snapshot with `asOf` fixed at `2025-11-05`.

The season segment is required. A malformed or unknown season returns `400`. See [Seasons and positions](/api-reference/leaderboard/seasons) for the segment format, the multiplier rows, and the position keys.

```bash theme={"dark"}
curl https://api.yieldpoint.io/v1/leaderboard/s2
```


## OpenAPI

````yaml https://api.yieldpoint.io/docs/json GET /v1/leaderboard/{season}
openapi: 3.0.0
info:
  title: YieldPoint API
  description: ''
  version: 1.1.0
  contact: {}
servers:
  - url: https://api.yieldpoint.io
security: []
tags: []
paths:
  /v1/leaderboard/{season}:
    get:
      tags:
        - Leaderboard
      summary: >-
        Returns the top 100 wallets by points for a season, with the multiplier
        schedule
      operationId: getLeaderboard
      parameters:
        - name: season
          required: true
          in: path
          description: Season, as "s" followed by the season number
          schema:
            example: s2
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeaderboardResponse'
components:
  schemas:
    LeaderboardResponse:
      type: object
      properties:
        season:
          type: number
        asOf:
          type: string
          description: Last closed New York day in the points tables
          nullable: true
        totalParticipants:
          type: number
          description: Number of ranked wallets
        multipliers:
          type: array
          items:
            type: object
            properties:
              position:
                type: string
                enum:
                  - hold_uty
                  - hold_yuty
                  - euler_collateral
                  - euler_lend
                  - pendle_yt
                  - pendle_lp
              multiplier:
                type: number
              firstDay:
                type: string
                description: New York calendar day, YYYY-MM-DD
              lastDay:
                type: string
                description: null while the window is open-ended
                nullable: true
            required:
              - position
              - multiplier
              - firstDay
              - lastDay
          description: >-
            Multiplier schedule, one row per window, ordered by position then
            firstDay. Empty for seasons without a schedule.
        entries:
          type: array
          items:
            type: object
            properties:
              rank:
                type: number
              user:
                type: string
              totalPoints:
                type: number
              dailyRate:
                type: number
                description: Points earned on asOf
            required:
              - rank
              - user
              - totalPoints
              - dailyRate
          description: Top 100 by rank
      required:
        - season
        - asOf
        - totalParticipants
        - multipliers
        - entries

````

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