Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

polynode exclusive — no other Polymarket data provider tracks position lifecycle state transitions.

​
Filters

FilterTypeDescription
wallet_addressesstring[]Wallets to watch. Max 500.
status_fromstringPrevious status (open, closed, redeemable, redeemed).
status_tostringNew status.

​
States

StatusMeaning
openWallet holds shares in an active market
closedPosition fully sold before resolution
redeemableMarket resolved, shares can be redeemed
redeemedShares redeemed, USDC claimed

​
Payload

{
  "id": "evt_c3d4e5f6-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
  "type": "position_status_change",
  "created_at": "2026-05-14T15:16:00.000000000+00:00",
  "data": {
    "wallet": "0xdb27bf2ac5d428a9c63dbc910c5e6e75560c0ae5",
    "token_id": "83970135942868...",
    "from_status": "open",
    "to_status": "redeemable",
    "amount": 15000.0,
    "realized_pnl": 8500.0,
    "market": "Will Bitcoin hit $100k by 2026?",
    "outcome": "Yes"
  }
}

​
Use Cases

  • Settlement bots: trigger auto-redemption when positions become redeemable
  • Portfolio trackers: show status transitions in real-time
  • Copy-trading: detect when a leader fully exits a position (open → closed)