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)