---
title: "Wallet PnL"
method: GET
path: "/v1/wallet/{address}/pnl"
tags: ["Wallet"]
---

# Wallet PnL

`GET /v1/wallet/{address}/pnl`

## Request

- Base URL: `https://api.hylo.so`
- URL: `https://api.hylo.so/v1/wallet/{address}/pnl`
- Auth: none declared
- TypeScript: <https://skmtc.dev/hylo/apis/hylo-public-api/docs/v1/wallet/:address/pnl/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `address` string, required

## Query parameters

- `tokens` string
- `lots` boolean

## Response `200`

Per-token PnL with totals; `warnings` lists partial-data conditions.

- Pnl
  - `wallet` string, required
  - `asOf` object, required
    - `slot` integer
    - `time` string
    - `checkpointDay` string, nullable: Newest checkpoint day any token resumed from; null when every pair was replayed from inception.
  - `tokens` object[], required
    - `symbol` string
    - `mint` string
    - `denomination` 'usd' | 'sol'
    - `holdings` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `costBasis` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `realized` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `unrealized` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `total` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `txCount` integer
    - `warnings` string[]
  - `totals` object, required
    - `realized` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `unrealized` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
    - `total` string: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
  - `warnings` string[], required

## Other responses

- `400`: Invalid parameter.

---

[API](https://skmtc.dev/hylo/apis/hylo-public-api.md) - [All operations](https://skmtc.dev/hylo/apis/hylo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hylo/apis/hylo-public-api/revisions/2a2fb3d7fee8?raw)