---
title: "Get Pnl History"
method: POST
path: "/api/v1/developer/wallet/pnl/history"
tags: ["PNL", "DEVELOPER", "WALLET"]
---

# Get Pnl History

`POST /api/v1/developer/wallet/pnl/history`

## Query parameters

- `min_liquidity` number — Minimum liquidity of which tokens must have to be included in the response.

## Request body

- PayloadHistoricalPnlByWallet
  - `start_timestamp` string, date-time, required — Start of time range (UTC ISO 8601)
  - `end_timestamp` string, date-time, required — End of time range (UTC ISO 8601)
  - `granularity` '1h' | '1d' | '1m' | '5m' | '15s', required
  - `addresses` PayloadAddress[], required — List of wallet chain+address pairs
    - `chain` string, required — Lowercase chain name
    - `address` string, required — Wallet address

## Response `200`

Successful Response

- ResponseEnvelopeUnionHistoricalPnlPnlError
  - `data` union — Single item response data of type T
    - HistoricalPnl
      - `chain` string, required — Lowercase chain name
      - `address` string, required — Wallet address
      - `pnl` TimeIntervalPnl[], required — PnL snapshots per time interval
        - `timestamp` string, date-time, required — Interval start time (UTC)
        - `unrealized_pnl` CurrencyAmount, required
          - `currency` 'USD'
          - `amount` string, required — Value in the specified currency
        - `realized_pnl` CurrencyAmount, required
          - `currency` 'USD'
          - `amount` string, required — Value in the specified currency
    - PnlError
      - `chain` string, required — Lowercase chain name
      - `address` string, required — Wallet address
      - `message` string, required — Error description
  - `items` union[], nullable — Response items of type T
    - union
      - HistoricalPnl
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address
        - `pnl` TimeIntervalPnl[], required — PnL snapshots per time interval
          - `timestamp` string, date-time, required — Interval start time (UTC)
          - `unrealized_pnl` CurrencyAmount, required
            - `currency` 'USD'
            - `amount` string, required — Value in the specified currency
          - `realized_pnl` CurrencyAmount, required
            - `currency` 'USD'
            - `amount` string, required — Value in the specified currency
      - PnlError
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address
        - `message` string, required — Error description
  - `error` string, nullable — Error message
  - `cursor` string, nullable — Pagination cursor for next page

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)