Explore markets
DevelopersDocumentation
Private beta
API referenceWallet intelligence

Understand who is trading.

Explore a Polymarket wallet’s profile, performance, positions, and trading history.

Wallet profile and performance

GET/users/:addressREST

Retrieve 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.

cURL
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

GET/users/:address/pnl-historyREST

Request 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
Implyra.Intelligence for the next move.
↑↓ to navigate to openesc to close