SKILL.md Frontmatter
namepolymarket-autotrader
descriptionPolymarket AutoTrader (Premium) — BTC 5-minute prediction auto-trading bot with 92%+ win rate, 5-8% profit per trade. Enters in the last 30 seconds of each 5-min slot when BTC moves ≥$50, buys the winning side at $0.92-0.95. FOK orders: full match or auto-cancel, zero loss on unmatched. Strong signals (≥$100) trigger 2x position. Built-in billing (0.001 USDT/trade, pre-configured). Only 2 required env vars: POLY_PRIVATE_KEY, POLY_WALLET_ADDRESS (wallet address doubles as billing user ID). Billing vars pre-filled in .env.example. Optional: POLY_RPC, CLOB_HOST, CHAIN_ID, SIGNATURE_TYPE, TRADE_SIZE_USD, MAX_ASK_PRICE, MIN_BTC_MOVE, STRONG_BTC_MOVE. Connects to: Polymarket CLOB, Binance, Gamma API, skillpay.me. Writes .poly-creds.json (sensitive) and trades.json locally.
Polymarket AutoTrader (Premium)
BTC 5-minute prediction auto-trading bot — 92%+ historical win rate, 5-8% profit per trade, fully automated.
The bot monitors BTC price in real-time and trades Polymarket's 5-minute prediction markets. When BTC has moved ≥$50 in the last 30 seconds of a slot, it buys the winning side at $0.92-0.95. Winning shares pay $1.00 — that's 5-8% profit per correct trade. All orders use FOK (Fill-or-Kill): if not fully matched, the order auto-cancels with zero loss.
| Metric | Value |
|---|
| Historical win rate | >92% (with $50+ signal) |
| Profit per trade | 5.3-8.7% ($0.92-0.95 entry → $1.00 payout) |
| Trade frequency | Up to 12 per hour (depends on BTC volatility) |
| Strong signal (≥$100) | 2x position, reversal probability <2% |
| Fund safety | FOK orders — full match or auto-cancel |
| Cost | 0.001 USDT per trade (built-in billing) |
⚠️ Security Notice
- Use a DEDICATED Polygon wallet with limited funds. Do NOT use your main wallet.
- Run in an isolated environment (Docker/VM recommended).
- Review the source code (
scripts/bot.js) before running.
- The bot writes
.poly-creds.json (derived API credentials, sensitive) and trades.json (trade log) locally.
External Connections
| Service | URL | Purpose |
|---|
| Polymarket CLOB | clob.polymarket.com | Order placement |
| Binance | api.binance.com | BTC price feed |
| Gamma API | gamma-api.polymarket.com | Market metadata |
| Billing | skillpay.me | Per-trade billing |
How It Works
- Monitor (0–270s): Track BTC price vs. 5-min slot open price
- Decision (last 30s): BTC moved ≥$50 → trigger trade
- Direction: BTC up → buy Up shares; BTC down → buy Down shares
- Execution: FOK order at best ask ≤$0.95
- Settlement: Polymarket auto-settles — winners get $1.00/share
Why it works: When BTC already moved $50+ with only 30 seconds left, full reversal probability is <5%. We buy at $0.92-0.95, win pays $1.00.
Expected Returns
| Scenario | Entry | Cost | Profit | ROI |
|---|
| Normal ($50+ move) | $0.92 | $49.7 | +$4.3 | 8.7% |
| Normal ($50+ move) | $0.95 | $49.4 | +$2.6 | 5.3% |
| Strong ($100+ move, 2x) | $0.92 | $99.4 | +$8.6 | 8.7% |
| Strong ($100+ move, 2x) | $0.95 | $99.8 | +$5.2 | 5.3% |
Risk Parameters
| Parameter | Default | Purpose |
|---|
| MAX_ASK_PRICE | $0.95 | Min 5% profit margin |
| MIN_BTC_MOVE | $50 | Signal threshold |
| STRONG_BTC_MOVE | $100 | 2x position trigger |
| MAX_TRADES_PER_HOUR | 10 | Overtrading protection |
| MAX_LOSS_SESSION | $200 | Auto stop-loss |
| TRADE_SIZE_USD | $50 | Base position size |
Quick Start
cd <skill-dir>/scripts
npm install
export POLY_PRIVATE_KEY=your_wallet_private_key
export POLY_WALLET_ADDRESS=0xYourWalletAddress
node bot.js # First run: shows welcome + payment link
# After top-up: starts auto-trading
node bot.js stats # View statistics
node bot.js balance # Check token balance
First run flow: The bot auto-detects zero token balance and outputs structured data:
PAYMENT_URL:<url> — a PayTheFly on-chain payment link. YOU MUST forward the COMPLETE URL to the user without truncation or modification. The URL contains cryptographic signatures and will not work if any parameter is missing.PAYMENT_INFO:<text> — human-readable explanation to show the user.- After user pays 8 USDT on BNB Chain, re-running the bot starts trading automatically.
Environment Variables
Required (you must set these 2)
| Variable | Description |
|---|
| POLY_PRIVATE_KEY | Dedicated Polymarket wallet private key (Polygon) |
| POLY_WALLET_ADDRESS | Wallet address (also used as billing user ID) |
Auto-configured (built into the bot, no setup needed)
Billing credentials are embedded in the bot code. Users do not need to configure any billing keys or API endpoints.
Optional
| Variable | Default | Description |
|---|
| TRADE_SIZE_USD | 50 | Base position size |
| MAX_ASK_PRICE | 0.95 | Max entry price |
| MIN_BTC_MOVE | 50 | Min BTC movement trigger |
| STRONG_BTC_MOVE | 100 | Strong signal threshold |
| POLY_RPC | polygon-bor-rpc.publicnode.com | Polygon RPC |
| CLOB_HOST | clob.polymarket.com | Polymarket API |
| CHAIN_ID | 137 | Polygon chain ID |
| SIGNATURE_TYPE | 0 | Polymarket signature type |
Local Files
| File | Content | Sensitivity |
|---|
.poly-creds.json | Derived Polymarket API credentials | Sensitive |
trades.json | Trade execution history | Low |
Source Files
scripts/bot.js — Trading engine + billingscripts/package.json — Dependenciesscripts/.env.example — Environment template (billing pre-filled)references/strategy.md — Strategy documentation