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 /v3/perps/wallets/{address}/positions/history

Position history

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/perps/wallets/{address}/positions/history \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "as_of": 1783739417178,
      "entry_price": "59.907",
      "instrument_id": 5,
      "mark_price": "59.904",
      "notional": "6781.612032",
      "side": "long",
      "size": "113.208",
      "symbol": "SILVER-USD",
      "unrealized_pnl": "-219.18727674172540875203195559"
    },
    {
      "as_of": 1783739417178,
      "entry_price": "4073.5",
      "instrument_id": 2,
      "mark_price": "4115.6",
      "notional": "100854.506552",
      "side": "short",
      "size": "-24.50542",
      "symbol": "GOLD-USD",
      "unrealized_pnl": "16.4260769474185793731707450"
    }
  ],
  "signer": "0xe666b1fed887af4c9cb8e8f6feb7fc1c537e74a5"
}

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 as_of timestamp. 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

x-api-key · string · header · required

Path Parameters

address · string · required

Polymarket proxy wallet or signer EOA (0x...). Resolved automatically.

Query Parameters

instrument · string

Restrict to one instrument

after · integer

Only rows after this time (Unix s or ms)

before · integer

Only rows before this time

limit · integer

Max rows (default 500)

Response

200 - application/json

Success