Polymarket Prediction Markets

Query real-time odds from Polymarket, the world's largest prediction market.

Quick Start

# Search for markets (instant via /public-search API)
polymarket search "Arsenal FC"
polymarket search "Super Bowl"
polymarket search "Bitcoin"
polymarket search "Trump"

# Browse by category
polymarket events --tag=sports
polymarket events --tag=crypto
polymarket events --tag=politics

# Get specific market details
polymarket market will-bitcoin-reach-100k

The CLI is at polymarket.mjs in this skill folder. Run with:

node /path/to/skill/polymarket.mjs <command>

Commands

Event Options

• --tag= - Filter by category (crypto, politics, sports, etc.)
• --limit= - Maximum results (default: 20)

Understanding Odds

Prices = Probabilities:

• 0.65 (65¢) = 65% chance of "Yes"
• Volume = total $ traded
• Liquidity = available $ in orderbook

Individual Match Betting

Polymarket has individual match markets for soccer, NFL, NBA, and more.

# Soccer - use "FC" suffix for team names
polymarket search "Arsenal FC"
polymarket search "Manchester United FC"
polymarket search "Liverpool FC"

# NFL/NBA - team name works
polymarket search "Patriots"
polymarket search "Chiefs"
polymarket search "Lakers"

Market types available:

• Moneyline: Win/Draw/Lose percentages
• Spreads: e.g., Arsenal -1.5
• Totals: Over/Under 2.5 goals
• BTTS: Both Teams to Score

Common Categories

API Reference

The CLI uses these public endpoints (no auth required):

• Search: GET /public-search?q= - keyword search
• Events: GET /events?active=true&closed=false - list events
• Markets: GET /markets?slug= - market details
• Tags: GET /tags - available categories

Base URL: https://gamma-api.polymarket.com

Notes

• Real money markets tend to be more accurate than polls/pundits
• Odds update in real-time as people trade
• Markets resolve to $1.00 (correct) or $0.00 (incorrect)