Documentation
OpenAPI
API referenceProfiles & positions

Trader profiles & positions.

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

On this page

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.Trader intelligence, ready to build.