Portfolio

Live perps positions and equity for a wallet, enriched per position with symbol, side, mark price and notional.

GET /v3/perps/wallets/{address}/portfolio

Wallet portfolio

cURL

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

200

{}

Fields

Field	Meaning
symbol	Instrument symbol, so no lookup table is needed
side	long / short, made explicit (raw size stays signed: negative = short)
mark_price	Live mark at response time
notional	Absolute position value at mark (derived, 2dp)

equity, size, entry_price, and unrealized_pnl keep their exact string precision.

Filters

Narrow the position list server-side (Polymarket returns the full list only): side, instrument, min_notional, min_roe, and sort (notional or pnl). Unknown values return a 400. To pull many wallets at once, use the batch portfolios endpoint.

Portfolio data refreshes every few seconds per wallet. Works with either address form — proxy or signer (details).

Authorizations

x-api-key · string · header · required

Path Parameters

address · string · required

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

Query Parameters

side · string

Filter positions: long | short

instrument · string

Restrict to one instrument

min_notional · number

Minimum position notional, USD

min_roe · number

Minimum return on equity

sort · string

Sort positions by notional | pnl

Response

200 - application/json

Success