oficcejo/alpha-arena-okx

這是什麼

alpha-arena-okx 是一個開源、AI 輔助的比特幣期貨交易機器人，專為 OKX 交易所設計。它會持續抓取市場數據，讓 DeepSeek-chat 模型生成買入/持有/賣出訊號，然後下達訂單（包含即時止損/止盈訂單）。基於 Streamlit 的 Web 儀表板會顯示帳戶餘額、持倉、價格圖表以及 AI 的最新決策。

核心元件

檔案 / 資料夾	角色
deepseekok2.py	主要交易迴圈 – 抓取 OHLCV 數據，呼叫 DeepSeek API，計算倉位大小，向 OKX 發送訂單並管理止損/止盈訂單。
streamlit_app.py	使用 Streamlit 建置的即時監控 UI – 顯示帳戶資訊、價格、利潤曲線以及帶有視覺效果的 AI 訊號。
run.py	寶塔 (宝塔) 面板使用的單一入口點，用於同時啟動機器人和 UI。
data_manager.py	簡單的記憶體內/共享數據存儲，讓機器人和 UI 讀取相同的最新市場/訊號資訊。
requirements.txt	Python 相依套件（例如 ccxt、streamlit、httpx）。
Docker 檔案 (Dockerfile, Dockerfile.trading, docker-compose.yml)	用於交易流程和 Streamlit UI 的容器化建置。
.env_template / .env	儲存 DeepSeek、OKX（以及可選的 Binance）的 API 金鑰和其他設定值。

運作方式

1. 數據收集 – 使用 ccxt 從 OKX 抓取 15 分鐘 K 線數據。
2. AI 決策 – 將近期的價格序列（以及一些技術指標值）發送給 DeepSeek-chat 模型。模型會回傳一個簡單的指令：buy、sell（做空）或 hold。
3. 倉位計算 – 一個公式結合了基礎 USDT 金額、信心乘數、最大倉位比例和趨勢強度因子來計算訂單大小。
4. 訂單執行 – 透過 OKX API 下達市價（或限價）訂單，然後立即建立真實的止損/止盈訂單，以便交易所可以在不等待 15 分鐘週期的情況下平倉。
5. 監控 – Streamlit 儀表板讀取共享狀態並顯示：
   • 帳戶權益和保證金使用量
   • 當前持倉和訂單 ID
   • BTC 價格和 24 小時變化
   • 盈虧曲線
   • AI 的最新推理（DeepSeek 回傳的文字）

部署選項

方法	使用時機	步驟（高階概述）
寶塔面板 (一鍵部署)	具有圖形控制面板的 VPS/雲端伺服器（推薦非技術使用者使用）。	安裝寶塔，新增一個 Python 項目管理器，上傳儲存庫，將 run.py 設定為啟動腳本，並在 .env 中填入金鑰。
Docker	本地開發或以容器為導向的生產環境。	git clone … && cd ds-main && cp .env.example .env && docker-compose up -d。
直接 Python	快速除錯或自訂開發。	建立虛擬環境，pip install -r requirements.txt，執行 python deepseekok2.py（機器人）和 streamlit run streamlit_app.py（UI），或者直接執行 python run.py。

設定重點

• AI 模型 – DeepSeek-chat (deepseek-chat)。API 金鑰放在 DEEPSEEK_API_KEY 中。
• 交易所 – OKX API 金鑰（OKX_API_KEY、OKX_SECRET、OKX_PASSWORD）。機器人以單向模式運作（根據設定，只能做多或只能做空）。
• 交易參數 – 在 deepseekok2.py 中的 TRADE_CONFIG下定義。重要的調整參數：
  • leverage（預設 10×）
  • timeframe（根據最新測試為 15m 或 1h）
  • 包含信心乘數和最大倉位比例的倉位管理區塊。
• 止損 / 止盈 – 在 v2.1 中啟用；機器人會在 OKX 上建立真實的演算法訂單，當價格觸及閾值時立即觸發。

適用對象

• 想要 AI 驅動的訊號層，但不想自己編寫模型的散戶加密貨幣交易者。
• 正在尋找將大型語言模型 API 整合到自動化交易流程中的現成範例的開發者。
• 任何有興趣在期貨市場上嘗試基於 AI 的風險管理（止損/止盈自動化）的人。

注意事項 / 警告

• 作者多次強調該策略無法持續穩定獲利；在投入真實資金之前，建議進行廣泛的測試。
• 僅支援單向持倉 – 您必須將機器人設定為只能做多或只能做空。
• 使用 API 會產生費用（DeepSeek token 定價），並且需要謹慎處理金鑰。
• 機器人依賴 OKX API 和 DeepSeek 服務的穩定性；服務中斷將導致交易停止。

---

以上所有資訊均直接取自儲存庫的 README；未推斷任何額外功能。