$npx -y skills add mjunaidca/polymarket-skills --skill polymarket-live-executorUse 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", "bu
| 1 | # Polymarket Live Executor |
| 2 | |
| 3 | Execute real trades on Polymarket with mandatory human-in-the-loop confirmation. |
| 4 | This skill requires L2 authentication (wallet private key) and enforces strict |
| 5 | safety controls on every operation. |
| 6 | |
| 7 | ## SAFETY REQUIREMENTS |
| 8 | |
| 9 | **Every trade requires explicit user confirmation.** The agent must: |
| 10 | |
| 11 | 1. Display full trade details (market, side, size, price, estimated cost) |
| 12 | 2. Show current order book context (spread, depth at target price) |
| 13 | 3. Wait for the user to type "yes" or "confirm" before proceeding |
| 14 | 4. Never batch or auto-confirm trades |
| 15 | |
| 16 | **Environment safeguards** (enforced by all scripts): |
| 17 | - `POLYMARKET_PRIVATE_KEY` must be set (burner wallet only -- NEVER a main wallet) |
| 18 | - `POLYMARKET_CONFIRM=true` must be set to enable any trade execution |
| 19 | - Position size hard-capped (default $10, configurable via `POLYMARKET_MAX_SIZE`) |
| 20 | - Daily loss limit tracked in `~/.polymarket-live/trades.log` |
| 21 | |
| 22 | ## Setup |
| 23 | |
| 24 | Use the setup wizard to configure everything: |
| 25 | |
| 26 | ```bash |
| 27 | # Step 1: Create a burner wallet |
| 28 | python scripts/setup_wallet.py --create |
| 29 | |
| 30 | # Step 2: Fund wallet with USDC on Polygon (manually via MetaMask/bridge) |
| 31 | |
| 32 | # Step 3: Copy and fill in .env |
| 33 | cp .env.example .env && chmod 600 .env |
| 34 | # Edit .env with your private key and limits |
| 35 | |
| 36 | # Step 4: Verify everything is configured |
| 37 | python scripts/setup_wallet.py --verify |
| 38 | |
| 39 | # Step 5: Check on-chain balance |
| 40 | python scripts/setup_wallet.py --check-balance |
| 41 | ``` |
| 42 | |
| 43 | Or set environment variables manually: |
| 44 | ```bash |
| 45 | export POLYMARKET_PRIVATE_KEY="0x..." # Burner wallet only! |
| 46 | export POLYMARKET_CONFIRM=true # Safety gate |
| 47 | export POLYMARKET_MAX_SIZE=10 # Max $ per trade (default: 10) |
| 48 | export POLYMARKET_DAILY_LOSS_LIMIT=50 # Max daily loss (default: 50) |
| 49 | ``` |
| 50 | |
| 51 | Review the `references/live-trading-checklist.md` before any live trade. |
| 52 | |
| 53 | ## Available Scripts |
| 54 | |
| 55 | ### 1. Execute Trade (`scripts/execute_live.py`) |
| 56 | |
| 57 | Place a real order on Polymarket. |
| 58 | |
| 59 | ```bash |
| 60 | # Limit order: buy 5 YES shares at $0.60 |
| 61 | python scripts/execute_live.py --token-id <ID> --side BUY --size 5 --price 0.60 |
| 62 | |
| 63 | # Market order: buy $5 worth at market price |
| 64 | python scripts/execute_live.py --token-id <ID> --side BUY --amount 5 --market |
| 65 | |
| 66 | # Sell: sell 10 shares at $0.75 |
| 67 | python scripts/execute_live.py --token-id <ID> --side SELL --size 10 --price 0.75 |
| 68 | ``` |
| 69 | |
| 70 | The script will display full trade details and require interactive confirmation. |
| 71 | |
| 72 | ### 2. Check Positions (`scripts/check_positions.py`) |
| 73 | |
| 74 | View wallet balance, open orders, and trade history. |
| 75 | |
| 76 | ```bash |
| 77 | python scripts/check_positions.py # Summary |
| 78 | python scripts/check_positions.py --orders # Open orders |
| 79 | python scripts/check_positions.py --trades # Recent trades |
| 80 | python scripts/check_positions.py --balance # USDC balance |
| 81 | ``` |
| 82 | |
| 83 | ## Workflow |
| 84 | |
| 85 | 1. Run analysis with polymarket-analyzer scripts to find opportunities |
| 86 | 2. Paper-trade the idea with polymarket-paper-trader first |
| 87 | 3. Review `references/live-trading-checklist.md` |
| 88 | 4. Set up environment variables and burner wallet |
| 89 | 5. Use `check_positions.py` to verify wallet state |
| 90 | 6. Execute trade with `execute_live.py` -- confirm when prompted |
| 91 | 7. Monitor position with `check_positions.py` |
| 92 | |
| 93 | ## Risk Controls |
| 94 | |
| 95 | - All trades logged to `~/.polymarket-live/trades.log` |
| 96 | - Daily P&L tracked and enforced against loss limit |
| 97 | - Position size caps prevent oversized trades |
| 98 | - No autonomous execution -- every trade needs human approval |
| 99 | |
| 100 | ## Important Disclaimers |
| 101 | |
| 102 | - This skill executes REAL trades with REAL money |
| 103 | - Use only with burner wallets funded with money you can afford to lose |
| 104 | - Past analysis does not guarantee future results |
| 105 | - Not financial advice -- you are solely responsible for your trades |