The Prediction Market Wallet APIs let developers access wallet-level portfolio, positions, trade history, activity, value data, and trader leaderboards for prediction-market users.
These endpoints are ideal for user dashboards, portfolio tracking, reporting, and wallet-level behavior analysis.
Key Benefits of the Wallet APIs
- Portfolio visibility – Summarize a wallet’s prediction-market exposure in one place.
- Open and closed position tracking – Show both live exposure and historical PnL.
- Activity insights – Reconstruct trades, market participation, and wallet activity feeds.
- Value monitoring – Track wallet value over time for charts and reporting.
- Trader intelligence – Surface active or leading wallets for profile and leaderboard experiences.
Wallet API Endpoints
The Wallet APIs offer eight core endpoints for wallet portfolio and trading analysis.
Get Wallet Portfolio Summary
GET /v4/data/prediction/wallets/{address}/portfolio
Retrieve a portfolio-level summary for a prediction-market wallet.
Useful for high-level wallet overviews, account cards, and summary widgets.
Get Wallet Open Positions
GET /v4/data/prediction/wallets/{address}/positions
Retrieve open positions for a wallet.
Useful for active exposure views, current holdings tables, and unrealized PnL tracking.
Get Wallet Closed Positions
GET /v4/data/prediction/wallets/{address}/history
Retrieve closed and resolved positions for a wallet.
Useful for realized PnL analysis, tax workflows, and historical performance reporting.
Get Wallet Trade History
GET /v4/data/prediction/wallets/{address}/trades
Retrieve trade history for a wallet.
Useful for execution logs, audit trails, and trader behavior analysis.
Get Wallet Activity Feed
GET /v4/data/prediction/wallets/{address}/activity
Retrieve wallet activity across relevant prediction-market actions.
Useful for account timelines, recent activity cards, and engagement surfaces.
Get Wallet Value Over Time
GET /v4/data/prediction/wallets/{address}/value
Retrieve wallet value data over time.
Useful for performance charts, account analytics, and PnL trend visualization.
Get Wallet Markets Traded
GET /v4/data/prediction/wallets/{address}/markets-traded
Retrieve the set of markets a wallet has traded.
Useful for trader profile pages, activity summaries, and market participation analytics.
Get Top Traders Leaderboard
GET /v4/data/prediction/top-traders
Retrieve leaderboard-style rankings for top prediction-market traders.
Useful for trader profile pages, leaderboard views, and wallet discovery surfaces.
Supported Platforms
- Primarily Polymarket-focused wallet analytics for position and history endpoints.
- Platform support may vary by endpoint, especially for wallet-level holdings and position data.
Use Cases for Developers
- Build wallet dashboards with portfolio summaries and open positions.
- Show historical PnL and resolved outcomes for reporting flows.
- Reconstruct wallet activity timelines and trade logs.
- Track wallet value trends and market participation over time.
- Build top trader leaderboards and wallet discovery experiences.
Wallet API FAQs
Which endpoints should I use for a portfolio dashboard?
A typical portfolio dashboard combines Get Wallet Portfolio Summary, Get Wallet Open Positions, Get Wallet Value Over Time, and Get Wallet Activity Feed.
What is the difference between positions, history, and trades?
Positions show currently held exposure, history focuses on closed or resolved positions, and trades capture execution-level buy and sell activity.
When should I use wallet activity instead of wallet trades?
Use wallet trades for execution-focused analysis. Use wallet activity when you want a broader chronological account feed that may include multiple action types beyond raw trades.
Can I use these endpoints for trader profile pages?
Yes. The wallet APIs are a strong fit for trader profile pages because they can expose portfolio summaries, markets traded, open positions, value trends, recent activity, and top-trader discovery in one place.