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

# Get KOL Calendar

> Returns one row per day for a given month with aggregate KOL realized PnL, volume, trade counts, and active wallet count. Useful for calendar and heatmap views.

## SDK Example

<CodeGroup>
  ```typescript SDK
  import { Client } from '@solana-tracker/data-api';

  const client = new Client({ apiKey: 'YOUR_API_KEY' });

  const data = await client.getPnlV2KOLCalendar({ year: 2025, month: 1 });

  ```
</CodeGroup>


## OpenAPI

````yaml /data-api/pnl-v2/openapi.json get /v2/pnl/leaderboard/kols/calendar
openapi: 3.1.0
info:
  title: SolanaTracker PnL V2 API
  description: >-
    Profit-and-loss tracking for Solana wallets. Provides wallet PnL summaries,
    token-level positions, leaderboards, KOL rankings, risk analysis, and
    historical performance data. All monetary values are in USD. All timestamps
    are Unix milliseconds unless noted otherwise.
  version: 2.0.0
servers:
  - url: https://data.solanatracker.io
    description: Production
security:
  - apiKey: []
tags:
  - name: Leaderboard
    description: Top traders, whales, and KOL rankings
  - name: Token
    description: Per-token trader and holder data
  - name: Wallet
    description: Wallet-level PnL, positions, history, and analysis
  - name: Batch
    description: Bulk wallet summaries and position lookups
paths:
  /v2/pnl/leaderboard/kols/calendar:
    get:
      tags:
        - Leaderboard
      summary: Get KOL Calendar
      description: >-
        Returns one row per day for a given month with aggregate KOL realized
        PnL, volume, trade counts, and active wallet count. Useful for calendar
        and heatmap views.
      operationId: getKOLCalendar
      parameters:
        - name: year
          in: query
          description: Calendar year. Defaults to the current year.
          schema:
            type: integer
        - name: month
          in: query
          description: Calendar month (1-12). Defaults to the current month.
          schema:
            type: integer
            minimum: 1
            maximum: 12
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  year:
                    type: integer
                  month:
                    type: integer
                  days:
                    type: object
                    description: >-
                      Map of day number (1-31) to that day's aggregated KOL
                      metrics.
                    additionalProperties:
                      type: object
                      properties:
                        realizedPnl:
                          type:
                            - number
                            - 'null'
                        volume:
                          type:
                            - number
                            - 'null'
                        buys:
                          type: integer
                        sells:
                          type: integer
                        traders:
                          type: integer
                          description: Number of KOLs active on this day.
                  summary:
                    type: object
                    properties:
                      tradingDays:
                        type: integer
                      positiveDays:
                        type: integer
                      negativeDays:
                        type: integer
                      totalRealizedPnl:
                        type:
                          - number
                          - 'null'
                      totalVolume:
                        type:
                          - number
                          - 'null'
              example:
                year: 2025
                month: 4
                days:
                  '1':
                    realizedPnl: 373982.77
                    volume: 9751829.32
                    buys: 12351
                    sells: 12491
                    traders: 208
                  '2':
                    realizedPnl: 229915.33
                    volume: 7904323.76
                    buys: 10781
                    sells: 10773
                    traders: 205
                  '3':
                    realizedPnl: 332834.92
                    volume: 5210481.27
                    buys: 7415
                    sells: 7616
                    traders: 196
                  '4':
                    realizedPnl: 280276.64
                    volume: 5410885.64
                    buys: 8862
                    sells: 8601
                    traders: 191
                  '5':
                    realizedPnl: 239014.53
                    volume: 5111185.32
                    buys: 7546
                    sells: 7734
                    traders: 177
                  '6':
                    realizedPnl: 367056.5
                    volume: 5133816.76
                    buys: 7752
                    sells: 7157
                    traders: 183
                  '7':
                    realizedPnl: 430358.23
                    volume: 6588608.92
                    buys: 10490
                    sells: 11075
                    traders: 196
                  '8':
                    realizedPnl: 491257.05
                    volume: 7579156.8
                    buys: 12258
                    sells: 13028
                    traders: 208
                  '9':
                    realizedPnl: 544439.69
                    volume: 10996111.37
                    buys: 15659
                    sells: 16232
                    traders: 219
                  '10':
                    realizedPnl: 398214.56
                    volume: 8691156.45
                    buys: 12516
                    sells: 12877
                    traders: 214
                  '11':
                    realizedPnl: 555314.07
                    volume: 7896454.15
                    buys: 11895
                    sells: 11820
                    traders: 206
                  '12':
                    realizedPnl: 466797.97
                    volume: 9569468.06
                    buys: 11944
                    sells: 12501
                    traders: 204
                  '13':
                    realizedPnl: 374398.53
                    volume: 8043832.87
                    buys: 10720
                    sells: 10896
                    traders: 194
                  '14':
                    realizedPnl: 699210.41
                    volume: 10746974.96
                    buys: 13478
                    sells: 14118
                    traders: 217
                  '15':
                    realizedPnl: 691944.98
                    volume: 12005395.16
                    buys: 15011
                    sells: 16273
                    traders: 223
                  '16':
                    realizedPnl: 461566.09
                    volume: 12644236.48
                    buys: 15832
                    sells: 17207
                    traders: 224
                  '17':
                    realizedPnl: 537137.83
                    volume: 12102591.98
                    buys: 15823
                    sells: 16267
                    traders: 224
                  '18':
                    realizedPnl: 359642.93
                    volume: 10468593.03
                    buys: 12614
                    sells: 12565
                    traders: 207
                  '19':
                    realizedPnl: 442822.67
                    volume: 8340065.03
                    buys: 10848
                    sells: 10797
                    traders: 205
                  '20':
                    realizedPnl: 400425.97
                    volume: 7433572.65
                    buys: 9784
                    sells: 9559
                    traders: 199
                  '21':
                    realizedPnl: 564925.96
                    volume: 12220263.74
                    buys: 14498
                    sells: 15320
                    traders: 223
                  '22':
                    realizedPnl: 678505.94
                    volume: 12730381.36
                    buys: 17046
                    sells: 17125
                    traders: 229
                  '23':
                    realizedPnl: 661277.23
                    volume: 14199282.07
                    buys: 20795
                    sells: 15759
                    traders: 235
                  '24':
                    realizedPnl: 459717.26
                    volume: 12550219.8
                    buys: 13645
                    sells: 12794
                    traders: 229
                  '25':
                    realizedPnl: 745882.41
                    volume: 15821963.93
                    buys: 16938
                    sells: 15230
                    traders: 235
                  '26':
                    realizedPnl: 649700.16
                    volume: 12371545.96
                    buys: 15655
                    sells: 12922
                    traders: 227
                  '27':
                    realizedPnl: 575217.3
                    volume: 12342470.46
                    buys: 13247
                    sells: 13637
                    traders: 222
                  '28':
                    realizedPnl: 583906.66
                    volume: 12675263.33
                    buys: 16563
                    sells: 14052
                    traders: 225
                  '29':
                    realizedPnl: 835732
                    volume: 16764899.32
                    buys: 18998
                    sells: 17204
                    traders: 238
                  '30':
                    realizedPnl: 1519120.06
                    volume: 13292838.26
                    buys: 17476
                    sells: 15472
                    traders: 238
                summary:
                  tradingDays: 30
                  positiveDays: 30
                  negativeDays: 0
                  totalRealizedPnl: 15950596.68
                  totalVolume: 306597868.2
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-codeSamples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


            const client = new Client({ apiKey: 'YOUR_API_KEY' });


            const data = await client.getPnlV2KOLCalendar({ year: 2025, month: 1
            });
      x-code-samples:
        - lang: typescript
          label: SDK
          source: >
            import { Client } from '@solana-tracker/data-api';


            const client = new Client({ apiKey: 'YOUR_API_KEY' });


            const data = await client.getPnlV2KOLCalendar({ year: 2025, month: 1
            });
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
      required:
        - error
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key for authentication

````