Prediction Market

Nansen's Prediction Market API endpoints provide comprehensive access to onchain prediction market data. Track positions, analyze market activity, find top traders, and discover trending events on Polymarket

What can you do?

With Prediction Market endpoints, you can:

• Discover trending markets and events: Screen markets by volume, liquidity, and activity to find what's moving

• Analyze wallet performance: Track any address's prediction market trades, positions, and PnL

• Find top traders: Identify the most profitable participants on specific markets

• Monitor market dynamics: Access orderbooks, price history (OHLCV), and trade flows for any market

• Browse by category: Filter markets by topic: politics, crypto, sports, and more

Which endpoints can I use?

I want to...	Use this endpoint	Best for
Find high-volume or trending prediction markets	Market Screener	Market discovery and trends
Browse and filter events by category, status, or volume	Event Screener	Event discovery
View price history for a specific market	OHLCV	Charting and trend analysis
See the current orderbook depth for a market	Orderbook	Liquidity analysis and entry/exit sizing
Find the largest position holders in a market	Top Holders	Identifying conviction holders
See all trades made by a wallet across prediction markets	Trades by Address	Wallet activity breakdown
View all trades on a specific market	Trades by Market	Market-level trade flow
See a wallet's PnL and win rate across all markets	PnL by Address	Trader performance analysis
See profitability rankings for a specific market	PnL by Market	Find top performers per market
Get full details on a wallet's open position in a market	Position Detail	Position monitoring
Browse available market categories	Categories	Navigation and filtering
PnL, Win rate and age of a wallet	Address Summary	Screening wallets

Key Concepts

Market vs Event

Prediction markets are organised into two levels:

Concept	Description	Example
Market	The fundamental tradable unit: a single binary Yes/No question	"Will ETH reach $5k in 2025?"
Event	A container that groups one or more related markets	"2025 Crypto Predictions" (containing multiple markets)

Positions and Shares

Unlike perp trading, prediction market positions are expressed as shares in a YES/NO outcome:

• A positive position = holding YES shares (bullish on the event)

• A negative position = holding NO shares (bearish on the event)

• Price ranges from $0 to $1, representing the implied probability

Platforms Covered

Nansen currently only supports data across Polymarket. We will be adding more platforms in the future.