Skip to main content
Browse prediction markets, track whale trades, monitor positions, and analyze market data

​
Capabilities

The Polymarket CLI is pre-installed in every container. Most commands work without any credentials — browsing markets, viewing trades, and checking positions are all public data.
  • Search and browse prediction markets
  • View market details, prices, and probabilities
  • Track trades by specific wallet addresses
  • Monitor open positions for any wallet
  • View leaderboards by PnL, volume, or markets traded
  • Get order book depth and price history
  • Browse market events, tags, and series
  • View trader profiles and comments
No API key required — all read operations (browsing, searching, tracking) work out of the box. A wallet is only needed if you want the agent to place orders.

​
Setup Guide

Polymarket is ready to use immediately — no setup required for browsing and analysis. Optional wallet setup is only needed for trading.

​
Ready to use — no configuration needed

The polymarket CLI is pre-installed in the container image. Just ask your agent to search markets, track trades, or view leaderboards.

​
Optional: Wallet for trading

If you want the agent to place orders, you’ll need to configure a Polygon wallet. See the Polymarket CLI docs for wallet setup instructions.
Caution: Trading involves real funds. Only configure a wallet if you understand the risks and want your agent to execute trades autonomously.

​
Usage Examples

Ask your agent to browse and analyze prediction markets. Search markets
“Search Polymarket for Bitcoin prediction markets”
“Find markets about the 2026 elections”
Top markets
“Show me the top 10 Polymarket markets by volume”
“What are the most liquid prediction markets right now?”
Track trades
“Show the last 50 trades for wallet 0xf5E6…”
“What positions does this address hold on Polymarket?”
Leaderboards
“Show today’s Polymarket leaderboard by PnL”
“Who are the top traders this week by volume?”

​
CLI Commands Reference

All commands use -o json for structured output.
ActionCommand
Search marketspolymarket -o json markets search "query"
List top marketspolymarket -o json markets list --limit 10 --active true
Get market detailspolymarket -o json markets get <id_or_slug>
List eventspolymarket -o json events list --limit 10
Get tradespolymarket -o json data trades <address>
Get positionspolymarket -o json data positions <address>
Leaderboardpolymarket -o json data leaderboard --period day
Order bookpolymarket -o json clob book <token_id>
Price historypolymarket -o json clob price-history <token_id>
Trader profilepolymarket -o json profiles get <address>