Trader profiles & positions.
Explore a Polymarket wallet’s profile, performance, positions, and trading history.
On this page
Wallet profile and performance
/users/:addressRESTRetrieve the profile and aggregate analytics for a wallet. The address must be a 0x-prefixed, 40-character hexadecimal Ethereum address. The example below uses a placeholder; replace it with the wallet you want to analyze.
WALLET_ADDRESS="0x0000000000000000000000000000000000000000"
curl --fail-with-body \
"$IMPLYRA_API_URL/users/$WALLET_ADDRESS"address / profileIdentity- The requested wallet address and available profile information.
portfolioValueUsdUSD- The wallet’s portfolio value.
unrealizedPnlUsd / totalRealizedPnlUsdUSD- Unrealized and aggregate realized profit and loss.
winRatePctPercentage- Wallet win-rate percentage. Availability depends on the underlying history.
totalClosedPositions / totalActivePositionsCounts- Counts of closed and active positions.
isPortfolioWhale / isSmartMoney / isInsiderClassification- Heuristic analytics labels. An insider flag describes a trading pattern and is not proof of privileged information.
availableBalanceUsdnumber | null- Available balance when known. Preserve null when unavailable.
Positions and activity
GET /users/:address/positionsPositions- Active positions for the wallet. Uses limit and offset pagination, with a maximum limit of 100.
GET /users/:address/closed-positionsHistory- Closed wallet positions. Uses limit and offset pagination, with a maximum limit of 100.
GET /users/:address/tradesTrades- Wallet trading history. Uses limit and offset pagination, with a maximum limit of 100.
Performance over time
/users/:address/pnl-historyRESTRequest a wallet’s historical profit and loss with a supported interval and fidelity.
intervalquery · string- One of 1d, 1w, 1m, or all.
fidelityquery · string- One of 1h, 3h, 12h, 18h, or 1d.
Treat classifications as context
Wallet labels summarize observed activity and portfolio characteristics. They can help you build discovery filters and research workflows, but they do not establish identity or guarantee future performance.
Wallet coverage is specific to the supported Polymarket dataset. A cross-venue market match does not create an equivalent wallet identity on Kalshi.
Questions about your integration?
hello@implyra.com