模擬盤到實盤:最小可行上線

設定 freqtrade dry-run 並驗證啟動

打開你在第 4 課建的 config.json,確認(或新增)以下欄位:

{
  "dry_run": true,
  "dry_run_wallet": 500,
  "stake_currency": "USDT",
  "stake_amount": 50,
  "max_open_trades": 5,
  "exchange": {
    "name": "binance",
    "key": "",
    "secret": ""
  },
  "stoploss": -0.05,
  "trailing_stop": false
}

幾個要點:

• "dry_run": true:模擬模式,不真的下單。這個欄位往後不要輕易改
• "dry_run_wallet": 500:設成你若要實盤計畫用的金額,讓模擬條件貼近現實
• stake_amount 設 50,每筆不超過模擬資金的 10%,符合第 6 課的倉位管理原則
• 在 dry-run 模式下,API key 和 secret 留空就可以跑(freqtrade 用公開端點抓行情)

啟動:

freqtrade trade \
  --config config.json \
  --strategy YourStrategy \
  --logfile logs/dry-run.log

啟動後立刻確認日誌裡有這一行——有這行才代表你真的在模擬模式:

2026-07-04 10:00:00 - freqtrade - INFO - Dry run is enabled. Using DRY_RUN_WALLET: 500

如果你看到的是 Running in LIVE mode,代表 "dry_run" 沒生效,立刻停機檢查設定檔。

跑滿一週:每日觀察清單

Dry-run 跑起來後,不是「放著等結果」。每天花 10 分鐘看這些數字,把觀察記錄在一個文字檔:

每日觀察清單 (dry-run 期間)

【Day 1】
□ freqtrade 有沒有順利連上交易所 API?
□ 第一筆模擬交易有沒有出現在 Telegram 通知?
□ Telegram 訊息格式是否包含:幣對、進場方向、模擬成交價、倉位大小

【Day 2–5 每日重複】
□ 今日最大回撤是多少?在回測預期範圍內嗎?
□ 今日開單頻率 vs 回測平均頻率:差距超過 50% 就要調查原因
□ 有沒有在深夜低流動性時段開了異常大的單?
□ freqtrade 程序有沒有崩潰過?看日誌的 ERROR / WARNING 行數

【Day 6–7 週末總結】
□ 跑 show-trades 撈出完整交易紀錄:
□ 計算:模擬成交點差 vs config 設定的 trading_fee——差多少?
□ 計算:實際開單數量是否符合 max_open_trades 限制?
□ 計算:模擬 win rate 和回測 win rate 的差距
□ 主觀評估:如果是真錢,你有沒有在某個時間點想手動平倉?

查看完整交易紀錄:

freqtrade show-trades \
  --config config.json \
  --db-url sqlite:///tradesv3.dryrun.sqlite \
  --print-json | python3 -m json.tool | head -100

一個殘酷的現實:七天的 dry-run 樣本太小,你看到的正報酬可能只是運氣。量化交易最小統計樣本通常要 100 筆以上交易。兩週才是最短的正式觀察週期。

如果決定實盤:最小化 API 權限

這是整堂課最重要的一步。到交易所建立一組專屬的 API 金鑰,不要複用你平常登入用的主帳號 API。

以 Binance 為例,API 管理頁面(登入後 → 帳戶 → API 管理):

API 權限設定(建議值):

✓  讀取資訊        開啟  ← 讓 bot 查帳戶餘額、行情
✓  現貨與槓桿交易   開啟  ← 讓 bot 下單
✗  合約交易        視策略,新手建議關閉
✗  提幣            絕對關閉  ← 紅線,任何情況下都不開
✗  萬用金鑰        絕對關閉
   IP 白名單       填入你的伺服器/VPS IP ← 強烈建議

為什麼提幣權限這麼危險?API 金鑰本質上是一串可以複製的字串。如果你的伺服器被入侵、.env 外洩、或 git 歷史裡有殘留,攻擊者拿到有提幣權限的金鑰可以直接把幣轉走——交易所通常不賠。沒有提幣權限,攻擊者頂多能亂下單,但不能把本金帶走。

把取得的金鑰填進設定——金鑰絕對不進 git,用環境變數管理:

# 在 .env 檔案裡:
FREQTRADE__EXCHANGE__KEY=你的API金鑰
FREQTRADE__EXCHANGE__SECRET=你的API密鑰

// config.json 把 key/secret 留空:
{
  "dry_run": false,
  "exchange": {
    "name": "binance",
    "key": "",
    "secret": "",
    "ccxt_config": {
      "defaultType": "spot"
    }
  }
}

啟動時 freqtrade 會自動從環境變數讀取——詳細設定參考 freqtrade 官方文件的「Security」章節。

設定 Telegram 即時監控

freqtrade 內建 Telegram 整合,是目前最省事的監控方案。

取得 Bot Token 和 Chat ID:

1. 到 Telegram 搜尋 @BotFather,傳 /newbot,照指示取一個 bot 名稱,拿到 Token(格式像 1234567890:ABCdefGHIjkl...)
2. 先傳一則訊息給你剛建的 bot(任何內容都可以)
3. 瀏覽器打開 https://api.telegram.org/bot你的Token/getUpdates,在回應的 JSON 裡找 "chat":{"id":XXXXXXXX},那個數字就是你的 Chat ID

把設定填進 config.json:

{
  "telegram": {
    "enabled": true,
    "token": "1234567890:ABCdefGHIjkl...",
    "chat_id": "12345678",
    "notification_settings": {
      "status": "on",
      "warning": "on",
      "startup": "on",
      "buy": "on",
      "sell": {
        "*": "on"
      },
      "buy_cancel": "on",
      "sell_cancel": "on",
      "protection_trigger": "on",
      "protection_trigger_global": "on"
    }
  }
}

重啟 freqtrade 後,手機應該會收到 Status: running 的訊息。測試一下常用的控制指令:

/status          查看當前持倉與浮動損益
/profit          顯示累計損益統計
/balance         查看帳戶各幣種餘額
/count           目前持倉數 / 最大持倉數
/logs 20         查看最近 20 行日誌(排查問題時很好用)
/forcesell all   緊急全部平倉——記住這個,關鍵時刻用

/forcesell all 是你的緊急煞車,務必先在 dry-run 測試過一次,確認它真的會觸發模擬平倉通知。

制定停機條件,並且提前寫下來

這是心理紀律的核心。停機條件要在上線之前定義,不是等到帳戶虧損時再根據情緒決定。

把下面這張表填好,截圖存到手機:

我的停機觸發條件 (上線前填寫)

帳戶總虧損超過 ____%,立刻停機,等七天再評估   (建議: 20%)
單日最大虧損超過 ____%,當日停機,次日重新評估  (建議: 5%)
策略連續虧損 ____ 筆,暫停並手動檢查策略邏輯   (建議: 10 筆)
交易所 API 斷線且未自動重連超過 ____ 分鐘,發警報 (建議: 15 分鐘)
程式崩潰且未重啟超過 ____ 分鐘,手動介入      (建議: 10 分鐘)

freqtrade 的 Protection 機制可以自動執行部分條件,在 config.json 加入:

{
  "protections": [
    {
      "method": "MaxDrawdown",
      "lookback_period_candles": 48,
      "trade_limit": 20,
      "stop_duration_candles": 4,
      "max_allowed_drawdown": 0.10
    },
    {
      "method": "StoplossGuard",
      "lookback_period_candles": 24,
      "trade_limit": 4,
      "stop_duration_candles": 2,
      "only_per_pair": false
    }
  ]
}

MaxDrawdown 的意思:最近 48 根蠟燭內,如果最大回撤超過 10%,自動停止開新單 4 根蠟燭。StoplossGuard 的意思:24 根蠟燭內觸發停損 4 次,暫停開單 2 根蠟燭。這是你的自動守衛,即使你在睡覺也會執行。

兩個重要原則:停機條件觸發後,不要在停機期間修改策略。先停下來觀察市場狀況,分清楚是策略失效還是市場 regime 改變,再決定下一步。