Position history
Perps Analytics
Position History
A wallet’s perps positions over time — how each position changed, opened, or closed, with equity and PnL trajectory. Polymarket only returns a wallet’s current portfolio; this is the accumulated history. Filter by instrument and time window (after/before). A read also captures a fresh snapshot when the latest is stale, so the current state is always included.
GET
Position history
Follow one wallet’s perps positions through time — how each position grew, shrank, opened, or closed, with the mark, notional, and unrealized PnL captured at each point. Filter to a single
instrument and bound the window with after / before.
Polymarket returns only a wallet’s current portfolio. This is the accumulated history of it, which exists nowhere else. Coverage begins when we started capturing (July 9, 2026) and grows continuously; each row carries its snapshot_ts. When you query, we also capture a fresh snapshot if the latest one is stale, so the current state is always part of what you get back.
Accepts either address form — profile address or signer — resolved automatically.Authorizations
Path Parameters
Polymarket proxy wallet or signer EOA (0x...). Resolved automatically.
Query Parameters
Restrict to one instrument
Only rows after this time (Unix s or ms)
Only rows before this time
Max rows (default 500)
Response
200 - application/json
Success

