Skip to main content
curl "https://api.polynode.dev/v3/perps/wallets/0x09b428f7c2b469786286214aa5c90dd9015f7320?key=$POLYNODE_API_KEY"
Accepts a Polymarket profile (proxy) address or the underlying account address — resolution is automatic. The response combines the mapping, registration status, and (for registered accounts) the live portfolio: 
{
  "input": "0x09b428f7c2b469786286214aa5c90dd9015f7320",
  "pm_address": "0x09b428f7c2b469786286214aa5c90dd9015f7320",
  "wallet_type": "deposit",
  "signer": "0x509e390373f5bde0bb02c1019ee39cf0ef23a1a4",
  "registered": true,
  "equity": "5350.00",
  "positions": [
    {
      "instrument_id": 6,
      "symbol": "BTC-USD",
      "size": "0.5",
      "side": "long",
      "entry_price": "61000",
      "mark_price": "62010",
      "notional": "31005.00",
      "unrealized_pnl": "505.00",
      "return_on_equity": "0.08"
    }
  ],
  "timestamp": 1783571023159
}
FieldMeaning
inputThe address you passed, normalized
pm_addressThe Polymarket proxy address (null for plain-EOA users)
signerThe perps account address
wallet_typeeoa, deposit, safe, or proxy — see wallet mapping
registeredWhether this account has activated perps
positionsEmpty for registered accounts with nothing open; absent portfolio fields for unregistered accounts
Unregistered wallets return registered: false with empty portfolio fields — a 200, not an error, so bulk scans stay simple.