playbooks

home / skills / openclaw / skills / polymarket-odds

polymarket-odds skill

/skills/deanpress/polymarket-odds

This skill lets you query Polymarket odds and events from the CLI, delivering real-time market prices and categories for informed bets.

npx playbooks add skill openclaw/skills --skill polymarket-odds

Review the files below or copy the command above to add this skill to your agents.

Files (3)
SKILL.md
3.0 KB
---
name: Polymarket
description: Query Polymarket prediction market odds and events via CLI. Search for markets, get current prices, list events by category. Supports sports betting (NFL, NBA, soccer/EPL, Champions League), politics, crypto, elections, geopolitics. Real money markets = more accurate than polls. No API key required. Use when asked about odds, probabilities, predictions, or "what are the chances of X".
---

# 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)

Overview

This skill provides a CLI for querying Polymarket prediction market odds, events, and market details without an API key. It lets you search markets by keyword, browse event categories, and fetch real-time prices, volume, liquidity, and orderbook depth. Use it to quickly convert market prices into implied probabilities for sports, politics, crypto, and geopolitics.

How this skill works

The CLI calls Polymarket public endpoints (no auth) to perform searches, list active events by tag, and retrieve market and token details. Commands map to public endpoints like /public-search, /events, /markets and /tags and return prices as probabilities (e.g., 0.65 = 65%). You run the script with node and provide commands such as search, events, market, price, and book to get structured, real-time market data.

When to use it

  • You want an instant probability estimate for a binary outcome (convert price to chance).
  • Comparing market-implied odds across sports, politics, crypto, or elections.
  • Monitoring liquidity and volume before placing trades or research.
  • Building a lightweight tool or script that pulls market data without OAuth or keys.
  • Checking current market prices or orderbook depth for a specific token or slug.

Best practices

  • Search markets by clear keywords or team names (use "FC" for soccer clubs).
  • Filter events with --tag to narrow results to sports, politics, crypto, etc.
  • Treat prices as dynamic; refresh queries for rapidly evolving markets.
  • Use volume and liquidity fields to assess how reliable the price is.
  • Refer to market slug exactly when requesting market details for precision.

Example use cases

  • Search "Super Bowl" to get latest market odds and implied win probabilities.
  • List all active crypto markets with events --tag=crypto and check price targets.
  • Fetch orderbook with book <token_id> before placing a trade to estimate slippage.
  • Query an election market to compare market-implied chances against polls.
  • Monitor a soccer match market (Arsenal FC) for live shifts in over/under or BTTS odds.

FAQ

Do I need an API key to use this CLI?

No. The CLI uses Polymarket's public endpoints that do not require authentication.

How do I interpret the price values?

Prices are probabilities where 0.65 equals a 65% implied chance the outcome resolves to $1.00.