polymarket-live-executor

What this skill does

# Polymarket Live Executor

Execute real trades on Polymarket with mandatory human-in-the-loop confirmation.
This skill requires L2 authentication (wallet private key) and enforces strict
safety controls on every operation.

## SAFETY REQUIREMENTS

**Every trade requires explicit user confirmation.** The agent must:

1. Display full trade details (market, side, size, price, estimated cost)
2. Show current order book context (spread, depth at target price)
3. Wait for the user to type "yes" or "confirm" before proceeding
4. Never batch or auto-confirm trades

**Environment safeguards** (enforced by all scripts):
- `POLYMARKET_PRIVATE_KEY` must be set (burner wallet only -- NEVER a main wallet)
- `POLYMARKET_CONFIRM=true` must be set to enable any trade execution
- Position size hard-capped (default $10, configurable via `POLYMARKET_MAX_SIZE`)
- Daily loss limit tracked in `~/.polymarket-live/trades.log`

## Setup

Use the setup wizard to configure everything:

```bash
# Step 1: Create a burner wallet
python scripts/setup_wallet.py --create

# Step 2: Fund wallet with USDC on Polygon (manually via MetaMask/bridge)

# Step 3: Copy and fill in .env
cp .env.example .env && chmod 600 .env
# Edit .env with your private key and limits

# Step 4: Verify everything is configured
python scripts/setup_wallet.py --verify

# Step 5: Check on-chain balance
python scripts/setup_wallet.py --check-balance
```

Or set environment variables manually:
```bash
export POLYMARKET_PRIVATE_KEY="0x..."    # Burner wallet only!
export POLYMARKET_CONFIRM=true           # Safety gate
export POLYMARKET_MAX_SIZE=10            # Max $ per trade (default: 10)
export POLYMARKET_DAILY_LOSS_LIMIT=50    # Max daily loss (default: 50)
```

Review the `references/live-trading-checklist.md` before any live trade.

## Available Scripts

### 1. Execute Trade (`scripts/execute_live.py`)

Place a real order on Polymarket.

```bash
# Limit order: buy 5 YES shares at $0.60
python scripts/execute_live.py --token-id <ID> --side BUY --size 5 --price 0.60

# Market order: buy $5 worth at market price
python scripts/execute_live.py --token-id <ID> --side BUY --amount 5 --market

# Sell: sell 10 shares at $0.75
python scripts/execute_live.py --token-id <ID> --side SELL --size 10 --price 0.75
```

The script will display full trade details and require interactive confirmation.

### 2. Check Positions (`scripts/check_positions.py`)

View wallet balance, open orders, and trade history.

```bash
python scripts/check_positions.py                # Summary
python scripts/check_positions.py --orders        # Open orders
python scripts/check_positions.py --trades        # Recent trades
python scripts/check_positions.py --balance       # USDC balance
```

## Workflow

1. Run analysis with polymarket-analyzer scripts to find opportunities
2. Paper-trade the idea with polymarket-paper-trader first
3. Review `references/live-trading-checklist.md`
4. Set up environment variables and burner wallet
5. Use `check_positions.py` to verify wallet state
6. Execute trade with `execute_live.py` -- confirm when prompted
7. Monitor position with `check_positions.py`

## Risk Controls

- All trades logged to `~/.polymarket-live/trades.log`
- Daily P&L tracked and enforced against loss limit
- Position size caps prevent oversized trades
- No autonomous execution -- every trade needs human approval

## Important Disclaimers

- This skill executes REAL trades with REAL money
- Use only with burner wallets funded with money you can afford to lose
- Past analysis does not guarantee future results
- Not financial advice -- you are solely responsible for your trades