112 lines
4.2 KiB
Markdown
112 lines
4.2 KiB
Markdown
|
# 🎯 Polymarket Copy Trade Tool
|
||
|
|
|
||
|
|
Auto-copy trades dari trader manapun di Polymarket.
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
- 👀 **Watch Trader** — Monitor aktivitas trading dari address wallet tertentu
|
||
|
|
- 📊 **Copy Buy** — Otomatis buy ketika trader buy, dengan sizing yang bisa di-setting
|
||
|
|
- 📉 **Copy Sell** — Otomatis sell ketika trader sell (market / limit)
|
||
|
|
- 💰 **Auto Sell** — Pasang limit sell otomatis setelah buy filled (sesuai target profit %)
|
||
|
|
- 🏆 **Auto Redeem** — Cek dan redeem posisi yang sudah WIN secara berkala
|
||
|
|
- 🔄 **Smart Position** — 1 market hanya buy 1x, tidak duplikat
|
||
|
|
- ✅ **Balance Check** — Cek saldo sebelum trade
|
||
|
|
- 🧪 **Dry Run Mode** — Test tanpa eksekusi trade sungguhan
|
||
|
|
|
||
|
|
## Setup
|
||
|
|
|
||
|
|
### 1. Clone & Install
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git clone <repo-url>
|
||
|
|
cd polymarket-copy
|
||
|
|
npm install
|
||
|
|
```
|
||
|
|
|
||
|
|
### 2. Configure Environment
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cp .env.example .env
|
||
|
|
```
|
||
|
|
|
||
|
|
Edit `.env` dengan setting Anda:
|
||
|
|
|
||
|
|
| Variable | Description | Default |
|
||
|
|
|---|---|---|
|
||
|
|
| `PRIVATE_KEY` | Private key wallet Polygon | (required) |
|
||
|
|
| `WALLET_ADDRESS` | Address wallet Anda | (required) |
|
||
|
|
| `TRADER_ADDRESS` | Address trader yang mau di-copy | (required) |
|
||
|
|
| `SIZE_MODE` | `percentage` (dari size trader) atau `balance` (dari balance sendiri) | `percentage` |
|
||
|
|
| `SIZE_PERCENT` | Persentase sizing | `50` |
|
||
|
|
| `MIN_TRADE_SIZE` | Minimum trade dalam USDC | `1` |
|
||
|
|
| `AUTO_SELL_ENABLED` | Aktifkan auto-sell | `true` |
|
||
|
|
| `AUTO_SELL_PROFIT_PERCENT` | Target profit % untuk auto-sell | `10` |
|
||
|
|
| `SELL_MODE` | `market` atau `limit` saat copy sell | `market` |
|
||
|
|
| `POLL_INTERVAL` | Interval polling (detik) | `15` |
|
||
|
|
| `REDEEM_INTERVAL` | Interval cek redeem (detik) | `60` |
|
||
|
|
| `DRY_RUN` | Mode simulasi tanpa real trade | `true` |
|
||
|
|
|
||
|
|
### 3. Run
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Development (auto-reload)
|
||
|
|
npm run dev
|
||
|
|
|
||
|
|
# Production
|
||
|
|
npm start
|
||
|
|
```
|
||
|
|
|
||
|
|
## How It Works
|
||
|
|
|
||
|
|
```
|
||
|
|
┌─────────────────────────────────────────────┐
|
||
|
|
│ WATCHER LOOP │
|
||
|
|
│ Poll Data API setiap N detik │
|
||
|
|
│ → Cek trade baru dari trader │
|
||
|
|
├─────────────────┬───────────────────────────┤
|
||
|
|
│ NEW BUY │ NEW SELL │
|
||
|
|
│ │ │
|
||
|
|
│ ✓ Cek posisi │ ✓ Cek ada posisi? │
|
||
|
|
│ ✓ Cek balance │ ✓ Cancel auto-sell │
|
||
|
|
│ ✓ Market order │ ✓ Market/Limit sell │
|
||
|
|
│ ✓ Retry loop │ ✓ Retry loop │
|
||
|
|
│ ✓ Auto-sell │ ✓ Remove position │
|
||
|
|
│ ✓ Save posisi │ │
|
||
|
|
├─────────────────┴───────────────────────────┤
|
||
|
|
│ REDEEMER LOOP │
|
||
|
|
│ Cek berkala posisi yang sudah WIN │
|
||
|
|
│ → Redeem on-chain via CTF contract │
|
||
|
|
└─────────────────────────────────────────────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
## Folder Structure
|
||
|
|
|
||
|
|
```
|
||
|
|
polymarket-copy/
|
||
|
|
├── src/
|
||
|
|
│ ├── config/index.js — Environment vars & settings
|
||
|
|
│ ├── services/
|
||
|
|
│ │ ├── client.js — CLOB client init & balance check
|
||
|
|
│ │ ├── watcher.js — Poll trader activity
|
||
|
|
│ │ ├── executor.js — Buy & sell logic
|
||
|
|
│ │ ├── position.js — Position management
|
||
|
|
│ │ ├── autoSell.js — Auto limit sell
|
||
|
|
│ │ └── redeemer.js — Redeem winning positions
|
||
|
|
│ ├── utils/
|
||
|
|
│ │ ├── logger.js — Color-coded logging
|
||
|
|
│ │ └── state.js — JSON state management
|
||
|
|
│ └── index.js — Main entry point
|
||
|
|
├── data/ — Runtime state (gitignored)
|
||
|
|
├── .env.example
|
||
|
|
├── .gitignore
|
||
|
|
└── package.json
|
||
|
|
```
|
||
|
|
|
||
|
|
## Important Notes
|
||
|
|
|
||
|
|
- ⚠️ **Test dengan DRY_RUN=true** terlebih dahulu
|
||
|
|
- ⚠️ **Gunakan SIZE_PERCENT kecil** untuk percobaan awal
|
||
|
|
- ⚠️ **Private key jangan di-commit** — sudah ada di .gitignore
|
||
|
|
- Butuh USDC.e di Polygon untuk trading
|
||
|
|
- Butuh sedikit MATIC untuk gas fee (redeem positions)
|