polymarket

# Polymarket CLI Skill

Trade prediction markets on Polymarket from the terminal. All commands use the `polymarket` binary.

## Prerequisites

Binary must be installed. If missing:
```bash
curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh
# Or build from source:
# cargo install --path /tmp/polymarket-cli
```

## Authentication

Most read commands work without a wallet. Trading requires setup:
```bash
polymarket setup                    # Interactive wizard
# Or manually:
polymarket wallet create            # New wallet
polymarket wallet import 0xKEY...   # Import existing
polymarket approve set              # Approve contracts (needs MATIC)
```

Config stored at `~/.config/polymarket/config.json`.

## Output

**Always use `-o json` when calling from scripts/agents** for machine-readable output:
```bash
polymarket -o json markets list --limit 5
polymarket -o json clob midpoint TOKEN_ID
```

## Common Workflows

### Browse & Research

```bash
# Search markets
polymarket markets search "bitcoin" --limit 10
polymarket -o json markets search "trump" --limit 5

# Get specific market
polymarket markets get MARKET_ID_OR_SLUG

# List by category
polymarket events list --tag politics --active true --limit 20
polymarket events list --tag crypto --limit 10

# Available tags
polymarket tags list
```

### Check Prices & Orderbook

```bash
# Price info (needs token ID from market data)
polymarket clob price TOKEN_ID --side buy
polymarket clob midpoint TOKEN_ID
polymarket clob spread TOKEN_ID

# Full orderbook
polymarket clob book TOKEN_ID

# Price history
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30
# Intervals: 1m, 1h, 6h, 1d, 1w, max

# Batch queries (comma-separated)
polymarket clob midpoints "TOKEN1,TOKEN2"
```

### Trading (Requires Wallet)

```bash
# Limit order: buy 10 shares at $0.45
polymarket clob create-order --token TOKEN_ID --side buy --price 0.45 --size 10

# Market order: buy $5 worth
polymarket clob mar...

# Polymarket Skill

Interact with Polymarket prediction markets via the official `polymarket` CLI.

## Installation

```bash
bash skills/polymarket/scripts/install.sh
```

This will:
1. Try installing pre-built binary
2. Fall back to building from source if GLIBC incompatible
3. Install to `~/.cargo/bin/polymarket`

## Quick Start

```bash
# Search markets (no wallet needed)
polymarket -o json markets search "bitcoin" --limit 5

# Get specific market
polymarket markets get will-trump-win-2024

# Check price
polymarket -o json clob midpoint TOKEN_ID

# See SKILL.md for full documentation
# See EXAMPLES.md for common patterns
```

## Files

- `SKILL.md` — Complete reference for OpenClaw agents
- `EXAMPLES.md` — Common usage patterns and scripts
- `scripts/install.sh` — Installation script
- `scripts/search.sh` — Search markets helper
- `scripts/get-market.sh` — Get market details
- `scripts/check-price.sh` — Check token price

## Requirements

- Rust (auto-installed by install.sh if missing)
- For trading: MATIC on Polygon for gas

## References

- [polymarket-cli GitHub](https://github.com/Polymarket/polymarket-cli)
- [Polymarket Docs](https://docs.polymarket.com)