sol-grid-bot

README

sol-grid-bot

🤖 基于 Telegram 的 Solana 链网格交易机器人

📋 项目简介

SolGridBot 是一个智能的网格交易机器人，通过 Telegram 接口为用户提供 Solana 链上代币的自动化网格交易服务。用户只需设置价格区间，机器人将在该区间内自动执行低买高卖的网格交易策略，帮助用户在震荡行情中获利。

• 🐛 Bug 报告：Issues
• 📧 使用交流：电报群

✨ 功能特性

• 🚀 图形化启动器：提供 Windows 图形化启动器，无需命令行操作，一键配置和启动
• 🔗 Sol 链支持：专为 Solana 链优化的交易体验
• 🎯 智能网格交易：在用户设定的价格区间内自动执行低买高卖策略
• 🔗 稳定币交易：使用 USDC 交易代币，避免主币波动风险
• 📱 Telegram 集成：通过 Telegram Bot 提供便捷的用户交互界面
• 📊 实时监控：通过 Telegram Bot 实时查询盈亏情况和历史交易
• 🛡️ 安全可靠：本地部署，私钥不离开用户环境
• 💻 易于部署：支持部署在笔记本、家庭电脑、服务器等环境
• ⚙️ 自动更新：启动器支持自动检测和下载最新版本

🏗️ 技术架构

• 开发语言：Go 1.24.1
• 数据库：SQLite3
• 消息接口：Telegram Bot API
• 价格数据：GMGN API/OKX Web3 API
• 架构模式：无外部依赖的单体应用

🚀 快速开始

📌 普通用户推荐：强烈建议使用 Launcher（启动器） 来运行网格机器人！Launcher 提供了图形化界面，可以自动下载最新版本、配置 API 密钥、验证配置、启动和停止程序，以及查看运行日志，让您无需手动编辑配置文件即可轻松使用。

🎯 使用 Launcher 启动（推荐，仅 Windows）

Launcher 是一个图形化启动工具，专为普通用户设计，提供以下功能：

• ✅ 自动下载最新版本：首次使用时自动从 GitHub Release 下载最新版本
• ⚙️ 图形化配置管理：通过界面配置 Solana RPC、OKX API、Telegram Bot，无需手动编辑配置文件
• 🔍 配置验证：自动验证配置项的有效性，确保配置正确
• 🚀 一键启动/停止：通过界面按钮轻松启动和停止机器人
• 📋 实时日志查看：在界面中实时查看程序运行日志，支持级别过滤
• 🔄 版本管理：自动检查更新，发现新版本时提示下载

使用步骤

1. 下载 Launcher

   • 前往 Release 页面
   • 根据您的系统架构下载对应的 Launcher 压缩包：
     • Windows 64位：launcher-v*-windows-amd64.zip
     • Windows 32位：launcher-v*-windows-386.zip

2. 解压并运行

   • 解压下载的压缩包到任意目录
   • 双击运行 launcher.exe

3. 配置和启动

   • Launcher 会自动检测并下载最新版本的机器人程序（如果不存在）
   • 在 Launcher 界面中配置必要的 API 密钥：
     • Solana RPC URL：点击"修改"按钮，输入 RPC 地址并验证
     • OKX API：输入 API Key、Secret Key 和 Passphrase 并验证
     • Telegram Bot：输入 Bot Token 并验证
   • 配置验证通过后，点击"启动"按钮即可运行机器人

4. 查看日志

   • 在 Launcher 界面底部可以实时查看程序运行日志
   • 支持按日志级别过滤（ALL、INFO、WARN、ERROR、DEBUG）

💡 提示：Launcher 会自动管理配置文件，您无需手动编辑 etc/config.yaml 文件。所有配置都可以通过 Launcher 界面完成。

💻 直接运行程序（开发者或 Linux 用户）

如果您是开发者，或者需要在 Linux 系统上运行，可以下载主程序并直接运行：

下载和运行

1. 下载程序

   • 前往 Release 页面
   • 根据您的系统架构下载对应的压缩包：
     • Linux 64位：sol-grid-bot-v*-linux-amd64.tar.gz
     • Windows 64位：sol-grid-bot-v*-windows-amd64.zip
     • Windows 32位：sol-grid-bot-v*-windows-386.zip

2. 解压文件

   • 解压下载的压缩包到目标目录

3. 配置和运行

   • 修改 etc/config.yaml 配置文件（参考下面的配置说明）
   • 运行可执行文件：

     # Linux
     ./sol-grid-bot -f etc/config.yaml
     
     # Windows
     ./sol-grid-bot.exe -f etc/config.yaml
     

🔨 从源码编译（开发者）

如果您想从源码编译，需要以下环境：

• Git
• Go 1.24.1 或更高版本

1. 克隆项目

git clone https://github.com/fachebot/sol-grid-bot.git

2. 安装依赖

go mod tidy

3. 构建项目

go build

4. 运行项目

# linux
./sol-grid-bot

# windows
./sol-grid-bot.exe

⚠️ 重要：运行项目前需要创建配置文件，请查看下面的配置说明。

⚙️ 配置说明

💡 使用 Launcher 的用户：如果您使用 Launcher 启动机器人，可以直接在 Launcher 界面中配置，无需手动编辑配置文件。Launcher 会自动创建和管理配置文件。

如果您选择直接运行程序，需要手动创建配置文件 etc/config.yaml，你可以复制 etc/config.yaml.sample 文件到 etc/config.yaml 并进行修改：

# Solana配置
Solana:
  RpcUrl: "https://api.mainnet-beta.solana.com" # 主网RPC地址
  MaxRetries: 1 # 重试次数
  SlippageBps: 250 # 滑点Bps
  MaxLamports: 5000000 # 每笔交易最高费用上限
  PriorityLevel: medium # 优先等级(medium/high/veryHigh)
  DexAggregator: jup # DEX聚合器(jup/okx/relay)

# Jup配置
Jupiter:
  Url: "https://lite-api.jup.ag" # Jupiter API地址
  Apikey: "" # Jupiter API密钥

# 数据API(gmgn/jupag/okx)
Datapi: gmgn

# Okx配置
OkxWeb3:
  Apikey:
  Secretkey:
  Passphrase:

# 代理服务器配置
Sock5Proxy:
  Host: 127.0.0.1 # 代理服务器地址
  Port: 10808 # 代理服务器端口
  Enable: true # 是否启用代理

# 电报机器人配置
TelegramBot:
  Debug: true
  ApiToken: 7916072799:AAFb-C25RgEAxNClxqeRpTkmO6C8e7FhzLs
  WhiteList:
    - 993021715

# 默认网格设置
DefaultGridSettings:
  OrderSize: 38 # 每格大小
  MaxGridLimit: 15 # 最大网格数量
  StopLossExit: 0 # 止损金额阈值
  TakeProfitExit: 80 # 盈利目标金额
  TakeProfitRatio: 3.5 # 止盈百分比(%)
  EnableAutoExit: true # 跌破自动清仓
  LastKlineVolume: 1000 # 最近交易量
  FiveKlineVolume: 8888 # 最近5分钟交易量
  GlobalTakeProfitRatio: 0 # 全局止盈涨幅(%)
  DropOn: true # 防瀑布开关
  CandlesToCheck: 3 # 防瀑布K线根数
  DropThreshold: 20 # 防瀑布跌幅阈值百分比(%)

# 快速启动网格设置
QuickStartSettings:
  OrderSize: 30 # 每格大小
  MaxGridLimit: 10 # 最大网格数量
  StopLossExit: 0 # 止损金额阈值
  TakeProfitExit: 80 # 盈利目标金额
  TakeProfitRatio: 3.5 # 止盈百分比(%)
  EnableAutoExit: true # 跌破自动清仓
  LastKlineVolume: 3000 # 最近交易量
  FiveKlineVolume: 20000 # 最近5分钟交易量
  UpperPriceBound: 0.0002 # 网格价格上限
  LowerPriceBound: 0.00005 # 网格价格下限
  GlobalTakeProfitRatio: 0 # 全局止盈涨幅(%)
  DropOn: true # 防瀑布开关
  CandlesToCheck: 3 # 防瀑布K线根数
  DropThreshold: 20 # 防瀑布跌幅阈值百分比(%)

# 创建代币策略的必要条件
TokenRequirements:
  MinMarketCap: 200000 # 最小代币市值
  MinHolderCount: 1500 # 最小代币持有人数
  MinTokenAgeMinutes: 240 # 最小代币年龄(分钟)
  MaxTokenAgeMinutes: 960 # 最高代币年龄(分钟)

除了 API 密钥需要使用自己的配置外，其他配置项可使用默认值。

获取必要的 API 密钥

1. SOL RPC URL

• 访问 QuickNode
• 注册免费账户
• 创建 SOL 主网节点
• 获取 RPC URL
• 将 RPC URL 填写到配置文件 Solana.RpcUrl 项

2. OKX Web3 API

• 访问 OKX Web3 开发者平台
• 使用钱包登录并且在账号设置界面绑定邮箱和手机
• 前往 API Key 页面创建一个新的 API Key
• 将 API Key、Secret Key 和 Passphrase 填写到配置文件 OkxWeb3 项

3. Telegram Bot Token

• 在 Telegram 中找到 @BotFather
• 发送 /newbot 创建新机器人
• 按提示设置机器人名称和用户名
• 获取 Bot Token
• 将 Bot Token 填写到配置文件 TelegramBot.ApiToken 项

网络代理配置

由于网络限制可能导致无法访问 Telegram Bot 服务器，用户可以配置 Sock5Proxy 代理来解决连接问题：

Sock5Proxy:
  Host: 127.0.0.1
  Port: 10808
  Enable: true # 设置为 true 启用代理

⚠️ 重要注意事项

安全风险

• 🔐 私钥安全：请确保私钥安全，建议使用专门的交易钱包
• 💾 数据备份：运行机器人后会自动创建 data 文件夹存储机器人数据，删除此文件夹将丢失所有数据，包括私钥，请谨慎操作

交易风险

• 💸 网络费用：每次交易都会产生 SOL 网络手续费
• 📈 市场风险：网格交易适合震荡行情，单边行情可能产生损失
• ⏰ 交易延迟：由于使用免费 API 服务，交易可能存在延迟，不适用于高波动代币交易

技术限制

• 🔄 API 限制：注意各 API 服务的调用频率限制
• 🛡️ 反爬虫机制：价格数据从 GMGN 和 OKX 抓取，如因反爬虫机制导致价格获取失败，可尝试修改配置文件 Datapi 选项

📄 免责声明

本项目仅供学习和研究使用，使用者需自行承担交易风险。请谨慎使用，作者不对任何损失负责。

在使用本软件进行交易前，请确保您：

• 充分理解网格交易的风险和机制
• 具备相应的技术知识和风险承受能力
• 仅使用您可以承受损失的资金进行交易