# 策略編輯器（回測&交易機器人）
**目錄**
1. 功能總覽
2. 如何建立策略
3. 如何執行回測
4. 如何建立交易機器人
5. 常見問題
### 一、功能總覽：什麼是策略編輯器？
策略編輯器是 CoinKarma 的核心功能，協助用戶利用 CoinKarma 的指標構建交易策略，並且進行回測驗證歷史績效，以及一鍵部署為自動化交易機器人。
主要包含三個核心概念：
* **策略 (Strategy)**：您的交易邏輯核心。定義在什麼條件下進場（開倉）與離場（平倉）的規則。
* **回測 (Backtest)**：策略的驗證機制。利用歷史數據模擬策略表現，提供報酬率、最大回撤 (MDD) 等關鍵數據分析。
* **交易機器人 (Trading Bot)**：策略的實戰應用。將驗證後的策略串接至 OKX 交易所，實現全自動化交易。
### 二、如何建立策略
您有兩種方式可以建立策略：
#### 方式一：自定義策略 (Custom Strategy)
適合有明確交易想法的用戶。
1. 點擊頁面上的 **「+ Create strategy」** 按鈕。
2. 在編輯器中輸入您的進出場邏輯與指標參數。
3. 確認無誤後點擊 **「Submit」**，即可在「My strategy」中查看該策略。
#### 方式二：使用官方推薦策略 (Recommended Strategy)
適合新手或想參考官方邏輯的用戶。
1. 切換至 **「Recommended」** 分頁。
2. 瀏覽官方精選的策略列表。
3. 選擇感興趣的策略，點擊 **「添加到我的策略」** (Add to my strategy)。
4. 系統將自動複製該策略至您的個人庫中，您可以直接使用或進行修改。
### 三、如何執行回測
在投入真實資金前，強烈建議先進行歷史回測。
1. 在策略頁面點擊 **「Run backtest」**。
2. 在彈出的視窗中設定回測參數：
* **時間起點/終點**：選擇您想驗證的歷史區間。
* **槓桿 (Leverage)**：設定模擬交易的槓桿倍數。
3. 點擊送出。系統將開始運算，依數據量大小，通常約需 **1-5 分鐘**。
4. 運算完成後，您將看到詳細的績效分析報告。
### 四、如何建立交易機器人
當您對策略的回測表現滿意後，可將其部署至 OKX 進行自動交易。
#### 步驟 1：綁定 OKX 帳戶
1. 點擊 **「Create bot」** 按鈕。
2. 系統將引導您綁定 OKX API（若尚未綁定）。
* 安全聲明：此 OKX API 權限為「唯讀權限(Read-Only)」，無法進行任何資金操作
* 注意事項：若您之前曾綁定失敗，請務必前往 OKX API 管理頁面刪除舊的 API Key，再重新進行綁定流程。
#### 步驟 2：提交審核與啟用
1. 綁定完成後，在確認視窗勾選同意條款並點擊 **「Submit」**。
2. 此時機器人狀態將顯示為 **Pending (審核中)**。請等待 OKX 系統審核（通常於 24 小時內完成）。
3. 審核通過後，狀態將更新為 **Active (啟用中)**。
#### 步驟 3：投入資金與開始交易
1. 點擊 **「Invest funds into OKX」** 按鈕，系統將跳轉至 OKX 的信號訂閱頁面。
2. 在 OKX 頁面上確認訂閱，並設定您欲投入的**保證金金額**與**槓桿倍數**。
3. 完成設定後，交易機器人即正式啟動。CoinKarma 將根據您的策略邏輯自動發送交易信號，由 OKX 執行下單。
### 五、常見問題
#### Q1：交易機器人的止盈 (Take Profit) 與止損 (Stop Loss) 該如何設置？
止盈與止損需直接於 OKX 交易所介面 進行操作。
**操作路徑：** 進入 OKX 倉位管理頁面 → 選擇信號機器人 → 點擊欲設置止盈止損的機器人點擊詳情 → 找到 **「止盈 (Take profit)」** 或 **「止損 (Stop loss)」** 選項進行數值設定即可。
**注意**：OKX 信號機器人的止盈止損採用「價格百分比」計算，即當價格相對於進場價達到設定的漲跌幅百分比時，系統將自動觸發平倉。
#### **Q2：如何設置交易機器人的交易槓桿 (Leverage)？**
槓桿倍數需在 **機器人的投入保證金階段** 設定。
* **操作說明：** 在您投入保證金 (Margin) 的頁面中，會有一併調整槓桿倍數的選項，請務必在提交機器人前確認槓桿倍數是否符合您的風險承受度。
#### **Q3：建立並提交機器人後，審核需要多久時間？**
在您提交機器人策略後，OKX 官方通常會於 **24 小時內** 完成審核流程。審核通過後，機器人即可開始接收信號並運作。
#### **Q4：交易機器人的進場倉位比例是按照「初始本金」還是「當前餘額」計算？**
機器人的進場信號採用 **動態餘額百分比 (Percentage of Balance)** 模式
* **計算方式：** 系統會根據您當前的「可用餘額」來計算下單金額。
* **複利效應：** 這意味著進場金額並非固定鎖定在「初始本金」，而是包含了「初始本金 + 已實現盈虧」。若策略獲利，隨後的下單金額會相應增加（複利）；反之則會相應減少。
#### **Q5：交易機器人會使用我的 API Key 進行交易嗎？**
**不會，請您放心。**
* **交易執行：** 我們的機器人是 CoinKarma 透過 **Webhook** 技術傳送交易信號給 OKX，並非直接透過 API 控制您的帳戶進行下單。
* **權限說明：** 若平台需要您提供 API Key，該 Key 僅具備 **「唯讀 (Read-Only)」** 權限，用途僅限於同步數據與展示績效，無法挪用資金或執行交易。
#### **Q6：有哪些國家或地區無法使用交易機器人服務？**
本服務依循 **OKX 交易所的合規政策**，部分地區因當地法律規範限制，可能無法使用相關服務（特別是衍生品交易）。
根據 OKX 最新的風險披露聲明，受限制的司法管轄區包括但不限於：
* **北美地區：** 美國（含所有海外領土）、加拿大。
* **亞太地區：** 香港、日本、馬來西亞、新加坡（僅限現貨，不支援衍生品）、韓國（限制衍生品服務）、孟加拉、印度、尼泊爾、北韓。
* **其他地區：** 英國（限制衍生品）、伊朗、俄羅斯、古巴、敘利亞、烏克蘭特定地區（克里米亞等）、阿爾及利亞、玻利維亞等。
> 注意： 合規地區名單可能隨 OKX 政策更新而變動，詳細與最新資訊請以 OKX 官方服務條款 公告為準。
#### Q7：交易機器人的分潤比例為何？
平台採行 **10% 的績效分潤機制 (Performance Fee)**。
僅當交易機器人為您產生實際獲利時，CoinKarma 才會收取該筆獲利的 10% 作為費用；若無獲利，則不收取費用。
#### **Q8：為何「最大回撤 (MDD)」與「實際平倉虧損」的金額不同？**
這是因為計算的基準不同。「平倉虧損」僅記錄**已實現**的結果（出場點）；而「最大回撤」則會計算持倉期間曾經歷過的**最大浮動虧損**（過程中的最低點）。
**舉例來說：** 假設您在BTC $100,000 時開多單。
1. 盤中價格一度跌至 **$80,000**（此時浮動虧損為 -20%，這會被計入最大回撤）。
2. 隨後價格反彈，您最終在 **$95,000** 時止損平倉（實際已實現虧損為 -5%）。
在這個案例中，您的實際虧損只有 **5%**，但策略的最大回撤會顯示 **20%**。這能更真實地反映該策略在極端行情下可能面臨的風險。
#### Q9：已經跑過回測的策略，可以修改參數重跑回測嗎？
可以，點擊「Edit strategy」編輯策略參數，然後再「Rerun backtest」即可修改參數重跑回測
#### Q10：**正在 OKX 上運行的交易機器人，可以修改策略參數並即時生效嗎？**
**可以。** 修改方式與回測相同，請點擊 「Edit strategy」 修改參數並儲存。 更新成功後，**新策略將立即生效**，CoinKarma 會即刻改用新的邏輯來發送交易信號，您無需停止機器人或重新部署。