> ## 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 Daily Breakdown

> Returns per-KOL performance for a single trading day, including realized PnL, volume, trade counts, and cumulative totals as of that date.

## SDK Example

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

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

  const data = await client.getPnlV2KOLByDate({ date: '2025-01-15' });

  ```
</CodeGroup>


## OpenAPI

````yaml /data-api/pnl-v2/openapi.json get /v2/pnl/leaderboard/kols/date
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/date:
    get:
      tags:
        - Leaderboard
      summary: Get KOL Daily Breakdown
      description: >-
        Returns per-KOL performance for a single trading day, including realized
        PnL, volume, trade counts, and cumulative totals as of that date.
      operationId: getKOLByDate
      parameters:
        - name: date
          in: query
          description: The date to query (YYYY-MM-DD). Defaults to today.
          schema:
            type: string
            format: date
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  traders:
                    type: array
                    items:
                      allOf:
                        - $ref: '#/components/schemas/DayTrader'
                        - type: object
                          properties:
                            identity:
                              $ref: '#/components/schemas/Identity'
                  summary:
                    type: object
                    properties:
                      totalRealizedPnl:
                        type:
                          - number
                          - 'null'
                      totalVolume:
                        type:
                          - number
                          - 'null'
                  date:
                    type: string
                    format: date
              example:
                traders:
                  - wallet: 525LueqAyZJueCoiisfWy6nyh4MTvmF4X9jSqi6efXJT
                    day:
                      realized: 54490.68
                      volume: 170539.07
                      cost: 52230.78
                      buys: 68
                      sells: 244
                    cumulative:
                      pnl:
                        realized: 130659.87
                        unrealized: 0
                        total: 130659.87
                      invested: 3299325.2
                      proceeds: 3300103.72
                    identity:
                      name: Joji
                      twitter: '@metaversejoji'
                      avatar: >-
                        https://kol-avatar.solanatracker.io/525LueqAyZJueCoiisfWy6nyh4MTvmF4X9jSqi6efXJT
                  - wallet: BtMBMPkoNbnLF9Xn552guQq528KKXcsNBNNBre3oaQtr
                    day:
                      realized: 43068.65
                      volume: 241060.48
                      cost: 99617.55
                      buys: 144
                      sells: 319
                    cumulative:
                      pnl:
                        realized: 1372534.67
                        unrealized: 0
                        total: 1372534.67
                      invested: 15063530.38
                      proceeds: 16228564
                    identity:
                      name: Letterbomb
                      twitter: '@@ihateoop'
                      avatar: >-
                        https://kol-avatar.solanatracker.io/BtMBMPkoNbnLF9Xn552guQq528KKXcsNBNNBre3oaQtr
                summary:
                  totalRealizedPnl: 691944.98
                  totalVolume: 12005395.16
                date: '2025-04-15'
        '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.getPnlV2KOLByDate({ date: '2025-01-15' });
      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.getPnlV2KOLByDate({ date: '2025-01-15' });
components:
  schemas:
    DayTrader:
      type: object
      description: A trader's activity and cumulative PnL for a single day.
      properties:
        wallet:
          type: string
        day:
          type: object
          properties:
            realized:
              type:
                - number
                - 'null'
            volume:
              type:
                - number
                - 'null'
            cost:
              type:
                - number
                - 'null'
            buys:
              type: integer
            sells:
              type: integer
        cumulative:
          type: object
          properties:
            pnl:
              $ref: '#/components/schemas/PnlBlock'
            invested:
              type:
                - number
                - 'null'
            proceeds:
              type:
                - number
                - 'null'
    Identity:
      type: object
      description: >-
        Unified wallet identity. Only fields with known values are returned; a
        wallet can carry multiple tags at once.
      properties:
        name:
          type:
            - string
            - 'null'
          description: Display name, if known.
        twitter:
          type:
            - string
            - 'null'
          description: Twitter/X handle, if known.
        avatar:
          type:
            - string
            - 'null'
          format: uri
          description: Avatar image URL.
        type:
          type:
            - string
            - 'null'
          description: >-
            Primary label for single-badge UIs, such as `kol`, `developer`,
            `pool`, `bot`, `hacker`, `spam_dusting`, `exchange`, or a platform
            tag.
        tags:
          type: array
          items:
            type: string
          description: >-
            All resolved labels for the wallet, including KOL, platform, pool,
            developer, bot, arbitrage, hacker, spam-dusting, or exchange tags.
        platforms:
          type: array
          items:
            type: string
          description: >-
            Normalized trading frontend tags such as `axiom`, `bloom`, or
            `photon`. Query filters also accept `axiom-flash`, which is
            normalized to `axiom` in identity responses.
        bot:
          type: object
          properties:
            name:
              type:
                - string
                - 'null'
            avatar:
              type:
                - string
                - 'null'
              format: uri
        pool:
          type: object
          properties:
            program:
              type:
                - string
                - 'null'
            poolAddress:
              type:
                - string
                - 'null'
        developer:
          type: object
          properties:
            token:
              type:
                - string
                - 'null'
            via:
              type: array
              items:
                type: string
            pools:
              type: array
              items:
                type: string
            creationTx:
              type:
                - string
                - 'null'
            createdAt:
              type:
                - integer
                - 'null'
              description: Unix timestamp in seconds.
        hacker:
          type: object
          description: Curated exploit/scam wallet label, when known.
          properties:
            label:
              type:
                - string
                - 'null'
        spamDusting:
          type: object
          description: Curated spam-dusting wallet label, when known.
          properties:
            label:
              type:
                - string
                - 'null'
        exchange:
          type: object
          description: Known centralized exchange hot wallet label, when known.
          properties:
            name:
              type:
                - string
                - 'null'
    Error:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message.
      required:
        - error
    PnlBlock:
      type: object
      description: Realized, unrealized, and total profit/loss in USD.
      properties:
        realized:
          type:
            - number
            - 'null'
          description: Profit/loss from closed trades (tokens fully or partially sold).
        realizedRaw:
          type:
            - number
            - 'null'
          description: >-
            Unfiltered realized PnL before `pnlMode` adjustments. Present on
            position rows and leaderboard period stats when available.
        unrealized:
          type:
            - number
            - 'null'
          description: >-
            Paper profit/loss on tokens still held, based on current market
            price.
        total:
          type:
            - number
            - 'null'
          description: Sum of realized + unrealized PnL.
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API Key for authentication

````