> ## 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 wallet rank

> One wallet's rank, points, and per-position breakdown for a season.

Returns the wallet's rank and points for the season, with a `breakdown` row per position. `rank` is `null` when the wallet has no points in the season; `totalPoints` is then `0` and `breakdown` is empty. `totalParticipants` is the number of ranked wallets, so `rank` is always between `1` and `totalParticipants` when present.

Each `breakdown` row reports the position's `multiplier` in force on `asOf`, its `valueUsd` on `asOf` summed across chains, the `dailyPoints` it earned on `asOf`, and the `totalPoints` it earned over the season. The wallet-level `dailyRate` and `totalPoints` are the sums of those columns.

The address must be a 0x-prefixed 40-character hex string and is case-insensitive. Anything else returns `400`. See [API overview](/api-reference/overview#addresses).

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


## OpenAPI

````yaml https://api.yieldpoint.io/docs/json GET /v1/leaderboard/{season}/{address}
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}/{address}:
    get:
      tags:
        - Leaderboard
      summary: Returns a wallet's rank, points and per-position breakdown
      operationId: getLeaderboardForAddress
      parameters:
        - name: address
          required: true
          in: path
          description: The wallet address
          schema:
            type: string
        - 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/LeaderboardAddressResponse'
components:
  schemas:
    LeaderboardAddressResponse:
      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
        user:
          type: string
        rank:
          type: number
          nullable: true
          description: null when the wallet has no points
        totalPoints:
          type: number
        dailyRate:
          type: number
        breakdown:
          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
                description: Multiplier in force on asOf
              valueUsd:
                type: number
                description: Position value on asOf, summed across chains
              dailyPoints:
                type: number
                description: Points earned on asOf
              totalPoints:
                type: number
                description: Points earned over the season
            required:
              - position
              - multiplier
              - valueUsd
              - dailyPoints
              - totalPoints
      required:
        - season
        - asOf
        - totalParticipants
        - user
        - rank
        - totalPoints
        - dailyRate
        - breakdown

````

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