這是一個支援對沖與做市策略的加密貨幣交易架構，具備多交易所自助接入與自訂策略擴充能力。系統內建自動化做市功能，可透過維持買賣價差獲取穩定收益。

使用邀請連結可獲得 10~35% 自返傭 (由官方自動發放)

Twitter：Yan Practice ⭕散修

• Web 控制台：直觀的圖形化界面，實時監控交易狀態和策略表現
• 多交易所架構：支援 Backpack、Aster、Paradex，可擴展至其他交易所
• 三種策略模式：
  • 現貨做市：多層訂單 + 智能重平衡
  • 永續做市：倉位管理 + 風險中性
  • Maker-Taker 對沖：即時對沖 + 零持倉
• 增強日誌系統：詳細的市場狀態和策略追蹤
• WebSocket 實時連接：即時市場數據和訂單更新
• 可選資料庫紀錄：根據需求啟用或停用資料庫寫入以兼顧效能

lemon_trader/
│
├── api/                  # API相關模塊
│   ├── __init__.py
│   ├── auth.py           # API認證和簽名相關
│   ├── base_client.py    # 抽象基礎客户端 (支持繼承開發接入任意交易所)
│   ├── bp_client.py      # Backpack Exchange 客户端
│   ├── aster_client.py   # Aster Exchange 客户端
│   └── paradex_client.py # Paradex Exchange 客户端 (含 JWT 認證)
│
├── ws_client/            # WebSocket模塊
│   ├── __init__.py
│   └── client.py         # WebSocket客户端
│
├── database/             # 數據庫模塊
│   ├── __init__.py
│   └── db.py             # 數據庫操作
│
├── strategies/           # 策略模塊
│   ├── __init__.py
│   ├── market_maker.py        # 現貨做市策略
│   ├── perp_market_maker.py   # 永續合約做市策略
│   └── maker_taker_hedge.py   # Maker-Taker 對沖策略
│
├── utils/                # 工具模塊
│   ├── __init__.py
│   └── helpers.py        # 輔助函數
│
├── cli/                  # 命令行界面
│   ├── __init__.py
│   └── commands.py       # 命令行命令
│
├── web/                  # Web 控制台界面
│   ├── __init__.py
│   ├── server.py         # Flask Web 服務器
│   ├── templates/        # HTML 模板
│   │   └── index.html
│   └── static/           # 靜態資源 (CSS, JS)
│       ├── css/
│       │   └── style.css
│       └── js/
│           └── app.js
│
├── docs/                 # 策略文檔
│   ├── SPOT_MARKET_MAKING.md      # 現貨做市策略說明
│   ├── PERP_MARKET_MAKING.md      # 永續合約做市策略說明
│   └── MAKER_TAKER_HEDGE.md       # Maker-Taker 對沖策略說明
│
├── config.py             # 配置文件
├── logger.py             # 日誌配置
├── run.py                # 統一入口文件
└── README.md             # 説明文檔

• Python 3.8 或更高版本（暫不支持 3.13 以上版本）
• 所需第三方庫：
  • PyNaCl
  • requests
  • websocket-client
  • numpy
  • python-dotenv
  • starknet-py
  • flask
  • flask-socketio
  • python-socketio

1. 克隆或下載此代碼庫:

git clone https://github.com/yanowo/Backpack-MM-Simple.git
cd Backpack-MM-Simple

2. 安裝依賴:

pip install -r requirements.txt

3. 設置環境變數:

複製 .env.example 為 .env 並添加:

# Backpack Exchange
BACKPACK_KEY=your_backpack_api_key
BACKPACK_SECRET=your_backpack_secret_key
BASE_URL=https://api.backpack.work

# WS 代理格式 http://user:pass@host:port/ 或者 http://host:port (若不需要則留空或移除)
BACKPACK_PROXY_WEBSOCKET=


# Aster Exchange
ASTER_API_KEY=your_aster_api_key
ASTER_SECRET_KEY=your_aster_secret_key

# Paradex Exchange (使用 Paradex 賬户認證)
# 需先登入 Paradex 使用 Paradex 地址與私鑰
PARADEX_PRIVATE_KEY=your_paradex_private_key
PARADEX_ACCOUNT_ADDRESS=your_paradex_account_address
PARADEX_BASE_URL=https://api.prod.paradex.trade/v1

# WS 代理格式 http://user:pass@host:port/ 或者 http://host:port (若不需要則留空或移除)
PARADEX_PROXY_WEBSOCKET=

# Optional Features
# ENABLE_DATABASE=1  # 啟用資料庫寫入 (預設0關閉)

本程序提供三種運行模式，您可以根據需求選擇：

推薦順序：新手建議先用 Web 控制台熟悉功能 → CLI 測試參數 → 快速啟動自動化運行

程序提供了直觀的 Web 控制台界面，方便可視化管理和監控交易策略。

# 啟動 Web 服務器（默認端口 5000）
python run.py --web

啟動後，在瀏覽器中訪問：

http://localhost:5000

• 實時監控：查看交易統計、餘額、盈虧等實時數據（每5秒更新）
• 策略管理：啟動/停止做市策略，支持多種策略類型
• 參數配置：
  • 交易所選擇（Backpack、Aster、Paradex）
  • 市場類型（現貨 / 永續合約）
  • 策略類型（標準做市 / Maker-Taker 對沖）
  • 交易對、價差、訂單數量等
  • 永續合約參數（目標倉位、最大倉位、止損止盈等）
  • 現貨重平衡參數
• 數據展示：
  • 當前價格和余額（只顯示報價資產 USDT/USDC/USD）
  • 交易統計（買賣筆數、成交量、手續費）
  • 盈虧分析（已實現/未實現盈虧、累計盈虧、磨損率）
  • 運行時間統計

1. 啟動 Web 服務器
2. 在瀏覽器打開控制台
3. 配置環境變量（API Key 需提前在 .env 文件中設置）
4. 選擇交易所和交易對
5. 設置策略參數
6. 點擊"啟動機器人"開始交易
7. 實時查看交易狀態和統計數據
8. 需要停止時點擊"停止機器人"

• Web 服務器需要持續運行以監控策略
• API 密鑰通過環境變量讀取，不會在 Web 界面中顯示
• 停止策略後統計數據會保留，方便查看最終結果

交互式命令行界面，提供菜單導航和逐步配置。

python run.py --cli

• 1 - 查詢餘額: 查看所有已配置交易所的資產餘額
• 2 - 查詢訂單簿: 查看指定交易對的買賣盤口
• 3 - 下單: 手動下單測試
• 4 - 取消訂單: 取消指定訂單
• 5 - 執行做市策略: 交互式配置並啟動做市策略
• 6 - 查看市場信息: 查看交易對詳細信息
• 7 - 查看波動率: 分析市場波動率
• 8 - 重平設置管理: 查看和測試重平衡配置
• 9 - 資料庫管理: 切換資料庫寫入功能
• 0 - 退出: 退出程序

適合場景：參數測試、功能驗證、逐步配置

直接通過命令行參數啟動策略，適合自動化部署和腳本運行。

# BackPack 現貨做市
python run.py --exchange backpack --symbol SOL_USDC --spread 0.01 --max-orders 3 --duration 3600 --interval 60

# BackPack Maker-Taker 現貨對沖
python run.py --exchange backpack --symbol SOL_USDC --spread 0.01 --strategy maker_hedge --duration 3600 --interval 30

# BackPack 永續做市
python run.py --exchange backpack --market-type perp --symbol SOL_USDC_PERP --spread 0.01 --quantity 0.1 --max-orders 2 --target-position 0 --max-position 5 --position-threshold 2 --inventory-skew 0 --stop-loss -1 --take-profit 5 --duration 3600 --interval 10

# BackPack Maker-Taker 永續對沖
python run.py --exchange backpack --market-type perp --symbol SOL_USDC_PERP --spread 0.01 --quantity 0.1 --strategy maker_hedge --target-position 0 --max-position 5 --position-threshold 2 --duration 3600 --interval 8

# Aster 永續做市
python run.py --exchange aster --market-type perp --symbol SOLUSDT --spread 0.01 --quantity 0.1 --max-orders 2 --target-position 0 --max-position 5 --position-threshold 2 --inventory-skew 0 --stop-loss -1 --take-profit 5 --duration 3600 --interval 10

# Aster Maker-Taker 永續對沖
python run.py --exchange aster --market-type perp --symbol SOLUSDT --spread 0.01 --quantity 0.1 --strategy maker_hedge --target-position 0 --max-position 5 --position-threshold 2 --duration 3600 --interval 15

# Paradex 永續做市
python run.py --exchange paradex --market-type perp --symbol BTC-USD-PERP --spread 0.01 --quantity 0.001 --max-orders 2 --target-position 0 --max-position 1 --position-threshold 0.1 --inventory-skew 0 --stop-loss -10 --take-profit 20 --duration 3600 --interval 10

# Paradex Maker-Taker 對沖
python run.py --exchange paradex --market-type perp --symbol BTC-USD-PERP --spread 0.01 --quantity 0.001 --strategy maker_hedge --target-position 0 --max-position 1 --position-threshold 0.1 --duration 3600 --interval 8

適合場景：自動化部署、定時任務、批量運行
完整示例和參數說明請查看：策略文檔

詳細的策略說明、參數配置和最佳實踐：

• 現貨做市策略 - 多層訂單、智能重平衡
• 永續合約做市策略 - 倉位管理、風險中性
• Maker-Taker 對沖策略 - 即時對沖、零持倉

• --api-key: API 密鑰 (可選，默認使用環境變數)
• --secret-key: API 密鑰 (可選，默認使用環境變數)
• --exchange: 交易所選擇 (backpack, aster, paradex)
• --symbol: 交易對 (例如: SOL_USDC)
• --spread: 價差百分比 (例如: 0.5)
• --quantity: 訂單數量 (可選)
• --duration: 運行時間（秒）
• --interval: 更新間隔（秒）
• --market-type: 市場類型 (spot 或 perp)
• --strategy: 策略選擇 (standard 或 maker_hedge)

• --enable-db / --disable-db: 資料庫寫入控制
• --target-position: 永續合約目標淨倉位
• --max-position: 永續合約最大允許淨倉
• --position-threshold: 永續倉位調整觸發值
• --inventory-skew: 永續做市報價偏移係數 (0-1)
• --stop-loss: 未實現止損閾值
• --take-profit: 未實現止盈閾值
• --enable-rebalance / --disable-rebalance: 重平衡控制
• --base-asset-target: 基礎資產目標比例 (0-100)
• --rebalance-threshold: 重平觸發閾值

完整參數說明和使用示例請查看各策略文檔

• 預設情況下，程式僅在記憶體中追蹤交易統計，不會寫入 SQLite 資料庫
• 透過環境變數 ENABLE_DATABASE=1 或命令參數 --enable-db 可啟用資料庫寫入
• 使用 --disable-db 可臨時停用資料庫
• 當資料庫功能關閉時，相關的歷史統計/報表選單會顯示為停用狀態

• 交易涉及風險，請謹慎使用
• 建議先在小資金上測試策略效果
• 定期檢查交易統計以評估策略表現
• 詳細的風險提示和最佳實踐請查看各策略文檔

程式採用模組化設計，支援多交易所擴展：

• Base Client 架構：抽象基礎類別，統一不同交易所的 API 介面
• 精確倉位管理：只平掉超出閾值的部分，避免過度平倉風控
• 分層日誌系統：市場狀態、策略決策、價格計算、執行結果四層資訊
• 相容性設計：支援多種 API 回應格式，強化錯誤處理機制

• 現貨做市策略
• 永續合約做市策略
• Maker-Taker 對沖策略