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

> A wallet's daily balances and points for a season, oldest day first.

Returns one row per New York calendar day on which the wallet held a tracked position during the season, oldest first. Only closed days are included.

Each day reports the `points` earned that day, the wallet's total position `valueUsd`, and `cumulativePoints` through that day. The last day's `cumulativePoints` equals the wallet's `totalPoints` from [Get wallet rank](/api-reference/leaderboard/get-address) exactly, so you can reconcile the two routes without rounding.

`positions` is the per-chain detail for the day. Unlike the breakdown on the wallet route, each row is one position on one chain: `position`, `chainId`, end-of-day `balance`, `valueUsd`, the `multiplier` in force that day, and the `points` that row contributed. Summing `points` across the rows gives the day's `points`.

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


## OpenAPI

````yaml https://api.yieldpoint.io/docs/json GET /v1/leaderboard/{season}/{address}/history
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}/history:
    get:
      tags:
        - Leaderboard
      summary: Returns a wallet's daily balances and points for a season
      operationId: getLeaderboardHistoryForAddress
      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/LeaderboardHistoryResponse'
components:
  schemas:
    LeaderboardHistoryResponse:
      type: object
      properties:
        season:
          type: number
        user:
          type: string
        days:
          type: array
          items:
            type: object
            properties:
              date:
                type: string
                description: New York calendar day, YYYY-MM-DD
              points:
                type: number
              valueUsd:
                type: number
              cumulativePoints:
                type: number
              positions:
                type: array
                items:
                  type: object
                  properties:
                    position:
                      type: string
                      enum:
                        - hold_uty
                        - hold_yuty
                        - euler_collateral
                        - euler_lend
                        - pendle_yt
                        - pendle_lp
                    chainId:
                      type: number
                    balance:
                      type: number
                    valueUsd:
                      type: number
                    multiplier:
                      type: number
                    points:
                      type: number
                  required:
                    - position
                    - chainId
                    - balance
                    - valueUsd
                    - multiplier
                    - points
            required:
              - date
              - points
              - valueUsd
              - cumulativePoints
              - positions
          description: Oldest first
      required:
        - season
        - user
        - days

````

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