Position Events

Real-time whale-activity feed: opened / closed / increased / reduced / flipped, built by diffing position snapshots. Filter by type, instrument, min_notional, address, liquidation, after.

GET /v3/perps/events

Position events

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/perps/events \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "address": "0x1198f33d4f889cafaf4a07a7dea55d615bf44ebc",
      "event": "increased",
      "instrument_id": 6,
      "liquidation": false,
      "mark_price": "64128",
      "new_size": "-1.04134",
      "notional": "66779.051520",
      "prev_size": "-0.99553",
      "symbol": "BTC-USD",
      "timestamp": 1783739413988,
      "unrealized_pnl": "-14.3833150202127"
    },
    {
      "address": "0x1198f33d4f889cafaf4a07a7dea55d615bf44ebc",
      "event": "flipped",
      "instrument_id": 8,
      "liquidation": false,
      "mark_price": "77.724",
      "new_size": "569.68",
      "notional": "44277.808320",
      "prev_size": "-588.63",
      "symbol": "SOL-USD",
      "timestamp": 1783739413988,
      "unrealized_pnl": "-143.05582313907624"
    }
  ]
}

A real-time whale-activity feed: opened, closed, increased, reduced, and flipped events, built by diffing each wallet’s position snapshots. Filter by type, instrument, min_notional, address, liquidation, and after. Polymarket has nothing like this — it exists only because we snapshot every account continuously.

Authorizations

x-api-key · string · header · required

Query Parameters

type · string

opened | closed | increased | reduced | flipped

instrument · string

Instrument id/symbol/asset.

min_notional · number

Only events >= this USD size.

address · string

One account.

liquidation · boolean

true | false

after · string

Only rows after this time (Unix s or ms).

limit · integer

Max rows.

Response

200 - application/json

Success