Polymarket Odds
Verified@deanpress
npx machina-cli add skill @deanpress/polymarket-odds --openclawPolymarket 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)
Overview
Query Polymarket prediction market odds and events from the command line. You can search markets by keyword, browse by category, and fetch current prices and market details without an API key. Real-money markets tend to offer sharper odds than polls.
How This Skill Works
The CLI uses Polymarket's public endpoints (no auth) via the gamma-api.polymarket.com base URL to fetch data. Use commands like search, events, market, price, and book to pull odds, events, and orderbook data. Prices map to probabilities, so a value of 0.65 equates to a 65% chance, with volume and liquidity showing trading activity.
When to Use It
- When you need current odds for a specific market (sports, politics, crypto, etc.).
- When you want to discover markets by category using tags like sports, politics, or crypto.
- When you need detailed market info by slug via the market command.
- When you want to inspect live prices and liquidity before trading with price and book.
- When comparing real-money odds to polls to gauge probabilities.
Quick Start
- Step 1: polymarket search Arsenal FC
- Step 2: polymarket events --tag=sports
- Step 3: polymarket market will-bitcoin-reach-100k
Best Practices
- Use search with precise keywords to locate markets quickly.
- Filter results with --tag to focus on specific categories (sports, politics, crypto).
- Remember that prices reflect probabilities; check liquidity before trading.
- Watch market status; act only on active markets and note that markets resolve to 1.00 or 0.00.
- Cross-check several markets for the same event to gauge consensus.
Example Use Cases
- Search for Arsenal FC to see current odds in soccer markets.
- Browse Super Bowl markets to compare prices and liquidity.
- Query will-bitcoin-reach-100k to see a price target market.
- Open politics markets around elections to assess probabilities.
- List crypto markets and inspect a specific market's price and orderbook.
