---
title: "Wallet Pnl History Chain"
method: GET
path: "/api/v2/wallet/{address}/pnl-history-chain"
---

# Wallet Pnl History Chain

`GET /api/v2/wallet/{address}/pnl-history-chain`

## Request

- Base URL: `https://orcalayer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://orcalayer.com/api/v2/wallet/{address}/pnl-history-chain`
- Auth: none declared

Chain-derived cumulative P&L timeseries from closed_positions_cache.

Polymarket user-pnl-api starts measurements from when they indexed the
wallet — for inactive whales like Theo4 (last trade Nov 2024) it returns
only the post-peak plateau, missing the ramp-up. closed_positions_cache
has every closed position with its actual close timestamp and realized
PnL, so we can reconstruct the real growth curve.

Daily-bucketed cumulative sum. Returns {address, source: "chain",
points: [{t: unix_ts, p: cumulative_pnl}, ...]}.

Coverage: ~3K wallets in cache (top earners + active syncs). Wallets
not in cache return empty points — frontend should fall back to
Polymarket user-pnl-api.

## Path parameters

- `address` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/orcalayer/apis/orcalayer-api.md) · [All operations](https://skmtc.dev/orcalayer/apis/orcalayer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orcalayer/apis/orcalayer-api/revisions/5d1d509daba6?raw)