Skip to main content
Read the prediction market positions a Polymarket wallet currently holds, and the collateral (USDC, pUSD) in it, on Polygon. This endpoint only reads positions; it does not place or open any. The response uses the same format as the Portfolio endpoint, with only the Polymarket protocol.
Cost: 1 credit per call
Pass the Polymarket wallet itself. Polymarket holds positions in a proxy wallet (the address shown on your Polymarket profile), not in the wallet you sign in with. This endpoint reads the address you pass as-is and does not look up the proxy wallet of a regular wallet, so a regular wallet returns no positions.
Interactive Playground: Test this endpoint in the API Playground. Get your API key at data.octav.fi

Endpoint

Parameters

string
required
Polymarket (proxy) wallet address on Polygon. Only one address is accepted per call; a comma-separated list returns 400 Multiple addresses not supported yet.
boolean
default:"false"
Return the portfolio without the address field. The endpoint takes one address, so there is nothing to combine and the positions are unchanged.

Example


Response

Returns an array holding one portfolio object. Positions are fetched live from Polymarket on every call.

Top-Level Fields

string
The wallet address (left out when aggregated=true)
string
Total value of the current positions and collateral, in USD
object
Contains a single polymarket key. Its chains.polygon.protocolPositions groups positions by type:
  • VAULT: current market positions, one per market outcome, named "<market title> - <outcome>" and valued at the position’s current value
  • WALLET: collateral (USDC, pUSD) sitting in the Polymarket wallet, named "Polymarket Wallet"
Each group carries a proxyAddress field with the Polymarket wallet.
object
Chain-level summary (Polygon only)

Example Response

Trimmed for readability: assets also carry chainContract, contract, decimal, images and P&L fields, as on the Portfolio endpoint.