polymarket-3

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