Polymarket Prediction Markets
Query real-time odds from Polymarket, the world's largest prediction market.
Quick Start
bash
# 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:
bash
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.
bash
# 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)