Aster Trading Bots

自動化交易機器人套件，用於 Aster 交易所的量化交易策略。

开源精神：本项目采用 GPL-3.0 协议，确保所有改进和衍生作品都回馈开源社区。

檔案結構

aster_bot/
├── bots/               # 交易機器人主程式
│   ├── hedge/          # 對沖機器人
│   ├── utilities/      # 工具程式
│   └── volume_maker/   # 刷量機器人
├── configs/            # 配置檔案
├── scripts/            # 啟動與停止腳本
├── states/             # 狀態儲存
├── reports/            # 報告文件
└── logs/              # 日誌檔案

功能特點

刷量機器人 (Volume Maker)

• 自動執行買賣循環刷交易量
• 支援多幣種配置
• 智能錯誤處理與重試機制
• 實時狀態監控
• V3 版本新增：
  • 間隔隨機化
  • 交易量隨機化
  • 突發交易模式
  • 安靜期機制
  • 最大手續費限制

對沖機器人 (Hedge Bot)

• 跨交易所對沖
  • 支援 CEX: Aster, Binance
  • 支援 DEX: Lighter.xyz, EdgeX Exchange
• 多空雙向持倉對沖
• 自動平衡倉位
• 資金費率套利
• Delta 中性策略

使用方式

環境設置

cp .env.example .env
# 編輯 .env 添加 API keys
pip install -r requirements.txt

啟動機器人

方法一：交互式啟動（推薦新手）

./scripts/start_volume_v3_interactive.sh

透過問答方式設定所有參數，提供預設值和建議。

方法二：進階啟動（完整參數）

# 查看所有參數
./scripts/start_volume_v3_advanced.sh --help

# 自訂參數範例
./scripts/start_volume_v3_advanced.sh \
    --symbol ETHUSDT \
    --interval 60 180 \
    --size 0.01 0.015 \
    --max-trades 50 \
    --max-fees 5

方法三：快速啟動（基本）

# V3 智能刷量（推薦）
./scripts/start_volume_v3.sh --symbol BTCUSDT --max-trades 100

# V2 刷量機器人
./scripts/start_btc_volume.sh

# 對沖機器人（需要雙向持倉模式）
./scripts/start_eth_hedge.sh

停止機器人

# 停止 V3 刷量機器人
./scripts/stop_volume_v3.sh

# 停止對沖機器人
./scripts/stop_hedge.sh

# 查看所有運行中的機器人
./scripts/monitor_all.sh

監控與管理

# 即時監控面板
./scripts/monitor_all.sh

# 查看即時日誌
tail -f logs/volume_v3_*.log

# 檢查倉位
python3 bots/utilities/aster_position_checker.py

注意事項

• 請確保 API keys 安全
• 對沖機器人需要帳戶開啟雙向持倉模式
• 建議使用子帳戶運行不同策略

風險警告

⚠️ 交易有風險，投資需謹慎

• 本項目僅供學習和研究使用
• 量化交易可能導致資金損失
• 使用前請充分測試並了解風險
• 作者不對任何交易損失負責

貢獻指南

歡迎貢獻！本項目採用 GPL-3.0 協議：

• 🔄 Fork 本項目
• 🌿 創建特性分支 (git checkout -b feature/AmazingFeature)
• 💾 提交更改 (git commit -m 'Add some AmazingFeature')
• 📤 推送到分支 (git push origin feature/AmazingFeature)
• 🎉 開啟 Pull Request

為什麼選擇 GPL-3.0？

我們相信量化交易策略應該開放共享，讓所有人都能受益：

• ✅ 強制開源：所有改進必須回饋社區
• ✅ 防止閉源商業化：確保代碼永遠自由
• ✅ 社區驅動：鼓勵協作和創新
• ✅ 技術透明：用戶可以完全審計代碼

授權協議

本項目採用 GNU General Public License v3.0 授權。

Copyright (C) 2025 ImL1s

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

詳見 LICENSE 文件。

支持項目

如果這個項目對你有幫助：

• ⭐ 給項目點個 Star
• 🐛 報告 Bug 或提出建議
• 🔧 貢獻代碼改進
• 📢 分享給更多人

聯繫方式

• GitHub Issues: 提交問題
• Pull Requests: 貢獻代碼