在 Polymarket 上自動執行的策略引擎。
Polymarket-bot 是一個自動交易機器人,目標市場是 Polymarket——以 Polygon 上 USDC 結算的預測市場。它把四種交易策略包進同一個執行迴圈:Arbitrage(套利)、DipArb(逢低買進)、Smart Money(跟單聰明錢)、Direct Trading(直接下單),並在每筆下單前加上一層風險檢查。
它要解決的問題是:預測市場的機會出現得快、結算邏輯固定,但人工盯盤與下單跟不上。這個機器人把訊號偵測、部位大小、風險上限、下單與監控自動化,並用 DRY_RUN 模式讓你在投入真實資金前先空跑驗證。整個程式以 TypeScript 寫成,主進入點是 bot-with-dashboard.ts,啟動後會一併開啟一個本機儀表板。
風控是這個專案的重點。它內建四層虧損上限——每日、每月、回撤、總虧損——以及動態部位大小、最低 $1.50 交易門檻(確保有足夠流動性出場)。跟單策略還會先過濾交易對象:勝率須達 60% 以上、獲利因子 1.5 倍、並通過一致性檢查,才會被複製。
掃描市場
策略訊號
風控檢查
部位大小
下單
監控 / 平倉
每一筆交易都必須通過每日、每月、回撤、總虧損四道風險上限,且不低於 $1.50 以保留出場能力。
從 clone 到儀表板啟動。
前置需求:Node.js 環境與一個 Polygon 上、持有 USDC 的錢包私鑰。依序執行以下指令,先安裝主程式,再建置儀表板,最後用 npx tsx 啟動。
# 1. 取得程式碼並安裝主程式依賴
git clone https://github.com/MrFadiAi/Polymarket-bot.git
cd Polymarket-bot
npm install
# 2. 建置儀表板
cd dashboard
npm install
npm run build
cd ..
# 3. 啟動機器人(含儀表板)
npx tsx bot-with-dashboard.ts環境變數:先用 dry-run 空跑
在 .env 設定錢包私鑰、起始資金與風險上限。第一次啟動時把 DRY_RUN 設為 true,機器人會走完整個決策流程但不送出真實訂單。
POLYMARKET_PRIVATE_KEY=0xYourPrivateKeyHere
CAPITAL_USD=250
DRY_RUN=true
DAILY_MAX_LOSS_PCT=0.05
MONTHLY_MAX_LOSS_PCT=0.15四種策略, 外加一層風控。
機器人提供四種可獨立開關的交易策略,搭配一組風控與監控元件。下表列出每一項的角色與用途。所有策略共用同一套風險上限與部位大小邏輯。
策略 · 01
Arbitrage
套利策略
鎖定 Polymarket 上的定價落差,在價差收斂前進場捕捉低風險利潤。
策略 · 02
DipArb
逢低買進
在價格回落時進場,結合套利條件篩選下跌中的進場點。
策略 · 03
Smart Money
跟單聰明錢
複製通過篩選的交易者:勝率 60% 以上、獲利因子 1.5 倍、並通過一致性檢查。
策略 · 04
Direct Trading
直接下單
由你自行決定方向與標的,機器人負責執行與風控管理。
風控 · 05
Risk Limits
多層風險上限
每日 5%、每月 15%、回撤 25%、總虧損 40% 四道上限,觸發即停止下單。
風控 · 06
Position Sizing
動態部位大小
依連續勝負調整每筆部位規模,連敗時縮小、連勝時放大。
風控 · 07
Min Trade Floor
最低交易門檻
每筆交易不低於 $1.50,確保部位有足夠流動性可以平倉出場。
工具 · 08
Dry Run
模擬模式
走完整策略與風控流程但不送出真實訂單,投入資金前先驗證行為。
工具 · 09
Dashboard
視覺化儀表板
localhost:3001 即時監控,提供策略開關、緊急停止與一鍵平倉(panic sell)。
該開哪個策略?
| 你想做什麼 | 適合的策略 |
|---|---|
| 捕捉市場定價落差 | Arbitrage |
| 在價格回落時找進場點 | DipArb |
| 複製高勝率交易者 | Smart Money |
| 自己決定方向與標的 | Direct Trading |
下單之前, 先過風控。
以下為 README 記載的風控與安全機制,並非社群實測技巧。每一條都對應程式中既有的保護邏輯。
四層虧損上限
每日 5%、每月 15%、回撤 25%、總虧損 40%。任一上限觸發後機器人停止開新倉,避免單日或單月的連續虧損擴大。
依官方 README · 風控設定
跟單前先篩選交易者
Smart Money 策略只複製通過門檻的對象:勝率 60% 以上、獲利因子 1.5 倍、並通過一致性檢查,降低跟到運氣帳戶的機率。
依官方 README · Smart Money
動態部位大小
部位規模隨連續勝負調整。連敗時自動縮小單筆下注,連勝時才放大,讓資金曲線在逆風時更平緩。
依官方 README · 部位管理
$1.50 最低交易門檻
每筆交易設有 $1.50 下限,確保部位規模足以在需要時平倉出場,而不會卡在無法成交的微小倉位。
依官方 README · 交易門檻
dry-run 模擬先行
把 DRY_RUN 設為 true,機器人會完整跑過策略與風控判斷但不送單。用於驗證設定與行為,再決定是否投入真實資金。
依官方 README · DRY_RUN
儀表板緊急控制
localhost:3001 儀表板提供策略開關、緊急停止與一鍵平倉(panic sell),讓你在市況異常時能立即介入。
依官方 README · Dashboard
一次 dry-run 到實盤的流程。
以下示範從設定 .env、啟動機器人、在儀表板觀察策略與風控,到關閉 dry-run 的流程。命令使用 repo 實際的啟動方式;市場數字僅為情境說明,非實際結果。
$ npx tsx bot-with-dashboard.ts
ok: [boot] strategies enabled: Arbitrage, DipArb, SmartMoney, Direct
hl: [Arbitrage] 偵測到價差機會 · 預估邊際利潤 1.8%
ok: [DRY_RUN] 模擬下單 BUY · $6.20 · 未送出
hl: [SmartMoney] 候選交易者勝率 54% → 未達 60% 門檻,略過
$ npx tsx bot-with-dashboard.ts
ok: [boot] dashboard → http://localhost:3001(緊急停止 / 一鍵平倉可用)
dry-run 會走完整個決策流程但不送單。 先讓行為符合預期,再投入真實資金。
這段流程為什麼重要
預測市場的下單是不可逆的鏈上交易。dry-run 讓你在不冒資金風險的前提下,先確認策略訊號、部位大小與風控上限的實際行為。儀表板則提供實盤時的即時監控與緊急介入。先驗證、後實盤,是降低自動交易風險最直接的一步。
自動交易的邊界與風險。
把機器人調成你的設定。
機器人的行為大多透過 .env 與 bot-config.ts 控制,不必改動核心程式碼即可調整風險上限、起始資金與策略開關。
進階玩法地圖
**1. 調整風控參數。**在 .env 修改 DAILY_MAX_LOSS_PCT、MONTHLY_MAX_LOSS_PCT 等上限,讓風險容忍度符合你的資金規模。
**2. 從 dry-run 轉實盤。**確認策略與風控行為後,把 DRY_RUN 改為 false。建議先用小額 CAPITAL_USD 起步。
**3. 逐一開關策略。**透過儀表板或設定,先單獨跑一種策略觀察表現,再決定是否同時啟用多個。
**4. 研究 poly-sdk 與 examples。**repo 內含 poly-sdk/ 與 examples/,是理解下單封裝與自訂行為的入口。
最該讀的延伸閱讀
四種策略、四層風控、一個儀表板, 全部開源,參數都在你手上。