---
title: "Wallet Pnl Events"
method: GET
path: "/api/v2/wallet/{address}/pnl-events"
---

# Wallet Pnl Events

`GET /api/v2/wallet/{address}/pnl-events`

## 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-events`
- Auth: none declared

Top realized-P&L events (closures) for the wallet within a period.

Powers clickable markers on the Performance Over Time chart — each event
renders as a dot on the chart with hover tooltip + click → market page.

Source: closed_positions_cache. Ordered by ABS(realized_pnl) DESC so the
most visually impactful wins/losses surface.

## Path parameters

- `address` string, required

## Query parameters

- `period` string: 1D, 1W, 1M, or ALL
- `limit` integer

## 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)