Polymarket

polymarket Plugin

CLI for Polymarket prediction markets. Browse markets, view prices, place orders, manage positions.

Commands

General

• polymarket self version — Print version
• polymarket self status — Check API health status

Markets

• polymarket markets list — List prediction markets
• polymarket markets search — Search prediction markets
• polymarket markets get — Get a single market by ID or slug

Events

• polymarket events list — List events

Order Book (CLOB)

• polymarket clob book — View order book for a token
• polymarket clob price — Get price for a token
• polymarket clob midpoint — Get midpoint price
• polymarket clob history — Get price history

Data

• polymarket data positions — Get positions for a wallet
• polymarket data leaderboard — View leaderboard

Wallet

• polymarket wallet show — Show wallet info

Tags

• polymarket tags list — List all tags

Usage Examples

• "List active prediction markets"
• "Search for markets about bitcoin"
• "Show order book for a token"
• "Get price history for a market"
• "Check Polymarket API status"

Installation

brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
brew install polymarket

Examples

# Browse markets
polymarket markets list --limit 10
polymarket markets search "election" --limit 5
polymarket markets get will-trump-win

# Order book
polymarket clob book TOKEN_ID
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID

# Price history
polymarket clob price-history TOKEN_ID --interval 1d

# JSON output for scripting
polymarket -o json markets list --limit 5

# Portfolio data
polymarket data positions 0xWALLET_ADDRESS
polymarket data leaderboard --period month --limit 10

Notes

• Read-only commands work without wallet setup
• For trading: run polymarket setup or set POLYMARKET_PRIVATE_KEY
• Output formats: -o json or -o table (default)