polymarket

name	polymarket
description	Use this skill when the user wants to browse Polymarket prediction markets, check market prices, view order books, search markets, or interact with Polymarket from the terminal.

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)