Wallet Overview

One call: resolve any Polymarket address, report the wallet type + signer, perps registration, and (if registered) the live enriched portfolio.

GET /v3/perps/wallets/{address}

Wallet overview

cURL

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

200

{}

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:

Field	Meaning
input	The address you passed, normalized
pm_address	The Polymarket proxy address (null for plain-EOA users)
signer	The perps account address
wallet_type	eoa, deposit, safe, or proxy — see wallet mapping
registered	Whether this account has activated perps
positions	[] for accounts with nothing open

Unregistered wallets return registered: false with equity: null, positions: [], and timestamp: null — a 200, not an error, so bulk scans stay simple.

Authorizations

x-api-key · string · header · required

Path Parameters

address · string · required

Polymarket proxy wallet or signer EOA (0x...). Resolution is automatic.

Response

200 - application/json

Success