Polymarket Skills BuilderandClaude Opus 4.6
068b2adc75
Composable Agent Skills (SKILL.md format) for Polymarket prediction market trading. Includes scanner, analyzer, monitor, paper trader, strategy advisor, and live executor. All tested against live Polymarket APIs. Security audited with all HIGH/MEDIUM findings resolved. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
102 lines
3.8 KiB
Markdown
102 lines
3.8 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
|
|
|
|
Before using this skill, the user must:
|
|
|
|
1. Create a burner wallet (see `references/security.md`)
|
|
2. Fund it with a small amount of USDC on Polygon
|
|
3. Set environment variables:
|
|
```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)
|
|
```
|
|
4. 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
|