Skip to main content

Polymarket CLI Research Tool

Research Polymarket prediction markets via the polymarket CLI. Look up events, generate interactive price charts, analyze wallets, and discover top holders.

Get StartedCommand Reference

Quick start

Get up and running with the Polymarket CLI in minutes

1

Install the polymarket CLI

Install via Homebrew on macOS or Linux:
brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
brew install polymarket
Verify installation:
polymarket --help
2

Look up an event or market

Retrieve event data with all outcome markets:
polymarket -o json events get democratic-presidential-nominee-2028
Or look up a single binary market:
polymarket -o json markets get will-donald-trump-win-2024
3

Generate an interactive price chart

First, get the decimal token ID from the condition ID:
polymarket -o json clob market 0x0f49db97f71c68b1e42a6d16e3de93d85dbf7d41
Then generate the chart:
python3 scripts/chart.py <DECIMAL_TOKEN_ID> --title "Market Name YES"
The script opens an interactive HTML chart in your browser with time-window tabs (1H, 6H, 1D, 1W, 1M, 3M, 6M, All).

Core features

Everything you need to research Polymarket prediction markets

Event and market lookup

Retrieve event metadata and outcome markets, or look up individual binary markets with prices and volume

Interactive price charts

Generate HTML price charts with time-window tabs and full history, powered by Plotly

Wallet analysis

Analyze wallet trade history, compute cost basis, and track position performance

Top holder discovery

Find the largest YES and NO holders for any market with position sizes

CLOB operations

Access CLOB market data, price history, order books, and token ID resolution

Market search

Search for markets by keyword and sort by volume or other metrics

Explore by workflow

Common research workflows for Polymarket data

Event lookup workflow

Retrieve event data, parse outcome prices, and access condition IDs for multi-outcome markets

View example

Price chart generation

Generate interactive HTML price charts with time-window tabs and full market history

Learn more

Wallet trade analysis

Analyze wallet positions, compute cost basis, and calculate ROI for prediction market trades

Learn more

Top holder discovery

Find the largest YES and NO holders for any market with position sizes and wallet addresses

Learn more

Ready to get started?

Install the polymarket CLI and start researching prediction markets with interactive charts and wallet analysis

Install now