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

Command	Description
search <query>	Search markets by keyword (recommended)
events [options]	List active events
market <slug>	Get market details by slug
tags	List available categories
price <token_id>	Get current price for a token
book <token_id>	Get orderbook depth

Event Options

• --tag=<slug> - Filter by category (crypto, politics, sports, etc.)
• --limit=<n> - 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

Tag	Markets
sports	NFL, NBA, soccer, tennis, etc.
politics	Elections, legislation, appointments
crypto	Price targets, ETFs, regulations
business	IPOs, acquisitions, earnings
tech	Product launches, AI developments

API Reference

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

• Search: GET /public-search?q=<query> - keyword search
• Events: GET /events?active=true&closed=false - list events
• Markets: GET /markets?slug=<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)