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

# Daily PnL calendar

> Daily PnL like the PnL calendar on hyperdash.com: one row per UTC day with the change in the wallet's account value minus the capital moved in or out, and that as a percentage of the previous close.



## OpenAPI

````yaml /data-api/openapi.json get /v1/accounts/{address}/pnl-calendar
openapi: 3.1.0
info:
  title: Hyperdash Data API
  version: v1
  description: >-
    Hyperliquid data from Hyperdash's own nodes and stored datasets; requests
    never call Hyperliquid's public API. Every response reports the credits it
    cost.
servers:
  - url: https://data.hyperdash.com
security: []
tags:
  - name: Accounts
  - name: Async jobs
  - name: Builders
  - name: Cohorts
  - name: HIP-3 dexes
  - name: Leaderboards
  - name: Lending
  - name: Liquidations
  - name: Markets
  - name: 'Markets: analytics'
  - name: 'Markets: funding'
  - name: 'Markets: liquidation and stop levels'
  - name: 'Markets: open interest and positioning'
  - name: 'Markets: order book'
  - name: 'Markets: prices and candles'
  - name: 'Markets: queue priority'
  - name: 'Markets: trades and flow'
  - name: 'Markets: TWAPs'
  - name: Network
  - name: Outcomes
  - name: Positions
  - name: Referrals
  - name: Snapshots
  - name: Spot
  - name: Staking
  - name: Traders
  - name: Vaults
paths:
  /v1/accounts/{address}/pnl-calendar:
    get:
      tags:
        - Accounts
      summary: Daily PnL calendar
      description: >-
        Daily PnL like the PnL calendar on hyperdash.com: one row per UTC day
        with the change in the wallet's account value minus the capital moved in
        or out, and that as a percentage of the previous close.


        **How it works**

        - The account value is the one from `GET
        /v1/accounts/{address}/account-value`. Each day's change runs from the
        previous close to the day's close, which is the day's last snapshot, at
        about 23:00 UTC.

        - For a classic account, with or without an open position, the account
        value is the equity on every perp dex plus the spot wallet. For unified
        and portfolio-margin accounts it is their pooled collateral.

        - The account value never includes lent tokens, staked HYPE or vault
        equity.

        - For a unified account, where spot and perps share one collateral pool,
        PnL is the change of that whole pool (available spot USDC, perp equity
        and its other tokens at their price) minus the capital moved in or out.
        Its moves between spot and perp are internal, and supplying to lending
        or staking HYPE takes value out.


        **Capital moved**

        - Deposits and withdrawals count.

        - Transfers with other wallets on any side (spot, perp or HIP-3 dex)
        count at their USD value.

        - Vault deposits and withdrawals count.

        - Borrow and lend: supplying or repaying takes value out, withdrawing or
        borrowing brings it in.

        - HYPE staking transfers count.

        - Moves between the wallet's own spot and perp balances do not count.

        - Stablecoins count at face value. HYPE and UBTC count at the HYPE or
        BTC perp's close of the last whole minute before the move.


        **History**

        - Before 2026-09-23 the stored account value is perp equity only, and
        the capital moves are the perp-cash ones: USDC deposits, withdrawals,
        transfers and moves between spot and perp.

        - Days before 2025-08-25 come from the wallet's fills.

        - When Hyperdash changes how the stored value is computed, the one-time
        step is booked as capital moved, not PnL. In 2026-11 a classic account
        with no open position started counting its spot wallet, as a positioned
        one already did.

        - The exceptions are a wallet that traded or moved capital within about
        an hour of the switch, and portfolio-margin accounts, whose valuation
        changed at the same time. Their switch day can carry part of the step.


        **Limits**

        - The range runs from `from` to `to` and is at most 366 dates, as on the
        site.


        **Known limits**

        - From 2026-09-23 until the 2026-11 change, a classic account with no
        open position was stored without its spot wallet, so on those days its
        spot-side transfers show as PnL. Those stored values cannot be rebuilt.

        - Lending interest and staking rewards are not counted as PnL, because
        they arrive with the moves.

        - Protocol and treasury wallets do not match their transfers, because
        their spot is token supply and is left out of their value.

        - A unified account emptied to zero keeps its last stored value until it
        holds funds again.

        - A unified account's spot USDC can trail a fast transfer by up to the
        snapshot interval, about an hour, and a day whose close predates a
        transfer recorded late can be off.

        - Idle collateral on a HIP-3 dex without a position is not counted.


        **Credits:** 40 per request + 1 per row.


        **Scope:** `analytics:read`
      operationId: getWalletPnlCalendar
      parameters:
        - name: address
          in: path
          required: true
          description: 'Wallet address: `0x` followed by 40 hex characters.'
          schema:
            type: string
        - name: from
          in: query
          required: false
          description: >-
            First UTC date, as YYYY-MM-DD. Defaults to 89 days before `to`,
            which gives the last 90 dates.
          schema:
            type: string
        - name: to
          in: query
          required: false
          description: Last UTC date, as YYYY-MM-DD. Defaults to today.
          schema:
            type: string
      responses:
        '200':
          description: OK
          headers:
            X-Credits-Charged:
              schema:
                type: integer
            X-Credit-Price-Version:
              schema:
                type: integer
            X-Request-Id:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - has_more
                  - next_cursor
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          description: UTC date.
                        pnl:
                          type: string
                          description: >-
                            Daily change in account value minus the capital
                            moved in or out, in USD. Decimal string.
                        pnl_pct:
                          type:
                            - string
                            - 'null'
                          description: >-
                            `pnl` as a percent of the previous close. Decimal
                            string.
                    description: Result rows.
                  has_more:
                    type: boolean
                    description: '`true` when another page follows.'
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Cursor for the next page, passed as `cursor`. `null` on
                      the last page.
                  meta:
                    type: object
                    description: >-
                      Response metadata. Its keys depend on the endpoint and are
                      described above.
        '400':
          description: 'Invalid parameter (also: a request body that is not valid JSON)'
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '401':
          description: Invalid, expired or revoked key
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Scope, plan, history or credit limit
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '409':
          description: Price version changed, or a cursor's snapshot expired
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: >-
            Rate limited (Retry-After; free): request rate, concurrent requests
            (a request counts one slot per 1,000 rows it can return), or this
            server busy with your workspace's requests
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '502':
          description: Upstream data source failed (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '503':
          description: Backend at capacity or temporarily unavailable (Retry-After)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '504':
          description: Upstream data source timed out (free; retry later)
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - bearer: []
      x-codeSamples:
        - lang: curl
          source: >-
            curl -H "Authorization: Bearer $HYPERDASH_API_KEY"
            'https://data.hyperdash.com/v1/accounts/0x…/pnl-calendar?from=2026-09-01'
components:
  schemas:
    Problem:
      type: object
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        code:
          type: string
        detail:
          type: string
        hint:
          type: string
        request_id:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your API key, sent as `Bearer hdk_sk_live_v1_…`.

````

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