Polymarket

README

# 🔮 Polymarket CLI Plugin

Trade prediction markets from the command line. Check balances, discover markets, place orders, track performance, and auto-redeem winning positions — all through structured JSON output.

## Features

- **💰 Account Management** — Check USDC.e, native USDC & POL balances
- **🔍 Market Discovery** — Search markets, view orderbooks, track prices
- **📊 15-Min Crypto Sniping** — Specialized tools for BTC/ETH/SOL 15-minute up/down markets
- **🛒 Trading** — Place GTC buy/sell orders, cancel orders
- **♻️ Auto-Redemption** — Batch redeem resolved positions to recover USDC.e
- **📈 Analytics** — PnL tracking, leaderboard access
- **🔐 On-Chain** — Direct Polygon contract interaction for approvals and redemptions

## Quick Start

```bash
# Check your balance
./polymarket.sh balance

# Search for markets
./polymarket.sh search "bitcoin"

# Check current 15-min window
./polymarket.sh window --asset btc

# View orderbook depth
./polymarket.sh book <tokenId> --depth 10

# Redeem all resolved positions
./polymarket.sh redeem-all --windows 10
```

## Requirements

- Node.js 18+
- Polygon wallet with USDC.e + POL for gas
- `POLYMARKET_PRIVATE_KEY` in your `.env` file
- One trade placed via Polymarket UI (activates API access)

## Commands

| Command | Description |
|---------|-------------|
| `balance` | Wallet balances (USDC.e, native USDC, POL) |
| `positions` | Current conditional token positions |
| `trades` | Recent trade history |
| `orders` | Open orders |
| `buy` | Place a buy order |
| `sell` | Place a sell order |
| `cancel` | Cancel an order |
| `cancel-all` | Cancel all orders |
| `search` | Search markets |
| `market` | Market details |
| `book` | Orderbook analysis |
| `price` | Quick price check |
| `window` | 15-min crypto window info |
| `snipe` | Quick entry on current window |
| `approve` | Approve USDC.e for exchanges |
| `redeem` | Redeem a resolved market |
| `redeem-all` | Batch redeem recent windows |
| `pnl` | Profit/loss summary |
| `leaderboard` | Top traders |

## Tech Stack

- TypeScript + ethers.js v5
- Polymarket CLOB SDK
- Polygon (Chain ID 137), legacy transactions
- Gas: 2× network price, min 25 gwei