Polymarket Skills BuilderandClaude Opus 4.6
22fcb4355b
New scripts: - health_check.py: one-command session-start workflow (portfolio + live prices + drawdown + stop losses → GREEN/YELLOW/RED status) - backtest.py: performance analysis with live-readiness assessment against CLAUDE.md prerequisites (20+ trades, >55% win rate, Sharpe >0.5) - correlation_tracker.py: detects hidden correlated exposure in portfolio (e.g., 3 insider-trading bets = one cluster) - setup_wallet.py: burner wallet creation, env var verification, on-chain balance check for live trading setup Also adds: - .env.example template for live trading configuration - .well-known/skills/index.json for Agent Skills registry discovery - Updated SKILL.md files documenting new scripts - .gitignore entries for .env, .polymarket-live/, and key files Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
118 lines
4.2 KiB
Markdown
118 lines
4.2 KiB
Markdown
---
|
|
name: polymarket-live-executor
|
|
description: >
|
|
Use this skill when the user wants to execute a real trade on Polymarket, place a live
|
|
order, go live, buy or sell on Polymarket, check real positions, or manage a live trading
|
|
wallet. Triggers: "execute trade", "live trade", "real trade", "go live",
|
|
"place order polymarket", "buy on polymarket", "sell on polymarket", "check positions",
|
|
"my balance", "cancel order", "live portfolio".
|
|
CRITICAL: This skill executes REAL trades with REAL money. Every trade requires explicit
|
|
human confirmation before execution. Never execute autonomously.
|
|
---
|
|
|
|
# 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
|