为你工作的智能网格交易机器人！

我们的许可证与您在购买后收到的唯一许可证密钥相关联。激活通过在程序中输入密钥完成。每个许可证对在不同计算机上的激活次数有限制。

根据购买的计划，您可以在以下设备上激活机器人：

• 同时1台设备(适用于月度和3个月计划)
• 同时2台设备(适用于6个月计划)
• 同时3台设备(适用于年度和2年计划)
• 同时5台设备(适用于终身许可证 – 每台新设备需要激活)

许可证系统验证设备的唯一标识符。如果活动设备数量超过限制，程序将无法在新计算机上启动。

ATHgrid许可证不会自动续订。在您的许可证到期前，您将收到一封提醒电子邮件，其中包含购买续订的链接。要继续使用机器人，只需购买符合您需求的新许可证。购买新许可证后，您的有效期将自动延长。

ATHgrid程序自动创建关键状态文件(如交易历史、仓位)和许可证文件(license_data.json)的备份。您可以配置这些备份在每笔交易后或每天发送到您的电子邮件，在硬件故障或文件损坏时保护您的数据。

license_data.json文件包含您的许可证密钥和激活令牌，以及许可证被激活的设备标识符。对于无需重新激活即可启动机器人至关重要。

重要：虽然可以移动license_data.json文件，但程序只会在已激活和注册的设备上启动，符合激活限制。如果丢失许可证密钥，您可以使用此文件在注册设备上恢复访问。

在哪里可以找到币安的API密钥？

• 登录您的币安账户。
• 转到个人资料(右上角人物图标)→API管理。
• 创建一个新的API密钥(例如”机器人系统”)。

应该授予API密钥什么权限？

• 启用读取权限和现货与杠杆交易选项。
• 不要启用提现权限。
• 建议：如果机器人在静态IP上运行，将IP地址添加到白名单。您可以在机器人应用程序中的”检查当前IP”按钮下找到当前IP。

如果出现”Invalid API keys!”或”API key authorization error”错误怎么办？

• 检查API Key和Secret Key是否正确复制(无额外空格)。
• 确保API密钥处于活动状态并具有所需权限。
• 如果使用IP白名单，确认机器人IP在列表中。

点击应用程序主窗口中的“添加新交易对”按钮。输入基础资产符号(如BTC、ETH、LTC)并选择报价货币(如USDC、USDT)。如果该交易对存在保存的配置，机器人会询问您是否要应用它。

• 最低价格：买单的最低价格。
• 最高价格：卖单的最高价格。
• 网格百分比：网格水平之间的百分比距离(例如2%表示每个水平高出2%)。
• 每水平金额：在每个网格水平上投入的报价货币金额(例如USDC)。

• 确保所有字段(API密钥、符号、网格参数)都填写了有效值。
• 检查您是否有足够的报价货币(如USDC)余额。
• 检查日志(bot_log_<SYMBOL>.log或控制台)中的错误。

• 买单：等待执行的活跃买单。
• 已完成仓位：购买的仓位等待卖出(或已放置卖单)。
• 历史记录：机器人执行的最近买卖交易。
• 网格水平概览：每个网格水平的状态(活跃订单、已完成仓位、利润)。

• 🟢 浅绿色：活跃买单。
• 🔴 浅红色：活跃卖单。
• 🔵 浅蓝色：已完成买单(等待卖出)。
• 🟡 浅黄色：已完成卖单(利润已实现)。
• ⚪ 浅灰色：非活跃水平。

启用后，先前交易的利润会被再投资，增加后续网格水平的基准金额。这基于复利原则，长期来看可以增加利润。

• 显示历史价格数据、当前价格和订单水平。
• 通过WebSocket实时更新，通过您的币安账户直接获取历史数据。如果不更新，请检查日志中的WebSocket或数据检索问题以及您的互联网数据传输速度。
• 使用下拉列表更改间隔(停止机器人更改间隔并重新启动)。

• Telegram通知包括：新/完成的买卖订单、再投资、错误和机器人状态。
• 电子邮件通知包括：机器人最重要文件的备份，在设备故障、文件损坏等情况下继续交易所必需。
• Telegram：使用机器人令牌和聊天ID配置(参见应用程序中的”Telegram帮助”部分)。
• 电子邮件：输入电子邮件地址并选择备份频率(“每笔交易”或”每天”)。

• 📜 检查日志：查看bot_log_<SYMBOL>.log和控制台中的错误或警告消息。
• 🌐 检查互联网：确保您有稳定的连接。
• 🖥️ 检查币安状态和您的IP：访问币安状态页面以及分配给您的API的IP(如果您不使用静态IP，您的IP可能会更改)。
• 🔄 同步状态：在长时间断开连接后重新启动机器人(机器人在网络断开时内置了等待重新连接的系统)。

• 错误”Quantity too small”或”Insufficient balance”：
  • 原因：订单金额低于币安最小值(LOT_SIZE)或资金不足。
  • 解决方案：增加每水平金额或减少网格百分比。
• 错误”NOTIONAL value is below minimum”：
  • 原因：订单价值(价格×数量)低于最小值(5-10 USDT/USDC)。
  • 解决方案：增加每水平金额。
• 错误”Duplicate sell order”：
  • 原因：该水平上已存在卖单(例如手动放置)。
  • 解决方案：机器人应取消重复订单；如果问题持续且您看到同一水平上有双重卖单或买单，请手动取消它们。机器人将重新正确设置订单。

• 原因：由于费用或四舍五入，资产数量不足。
• 解决方案：
  • 将MIN_SELL_QUANTITY设置为低值(如允许，设置为0.00000001)。
  • 增加每水平金额以覆盖费用。
  • 手动在币安上购买少量基础资产(如BTC/USDC的BTC)，以弥补费用差异。

• 确保机器人正在运行。
• 检查日志中的matplotlib、mplfinance或WebSocket错误。
• 验证互联网连接。
• 切换图表可见性(“隐藏/显示图表”按钮)。

与币安API通信的一般错误。检查日志中的详细信息。检查您的IP是否已更改并与币安账户API设置中的IP进行比较。如果需要，请更新。

• 停止机器人。
• 删除trading_bot_state_<SYMBOL>.json和start_time_<SYMBOL>.json文件。
• 重新启动机器人以重置状态。

点击通知部分中的“关闭标签”并确认。

使用启动屏幕或主窗口(右上角)中的语言选择下拉列表。

文件(日志、状态、配置)保存在机器人可执行文件所在的目录中。

可以，应用程序支持多个标签用于不同的交易对。

网格交易是一种交易策略，涉及在不同预定价格水平上放置一系列买卖订单。这些水平在当前市场价格周围形成一个”网格”。基本原则很简单：以自动化方式“低买高卖”。当价格下跌时，触发买单。当价格上涨时，触发卖单，实现先前购买仓位的利润。

ATHgrid以动态和智能的方式实施网格交易策略，以最大化资本效率。

动态订单网格(智能资金管理)

• 机器人分析当前市场价格。
• 仅在当前价格下方两个最接近的水平放置买单。
• 仅为当前价格上方两个最接近的已有仓位放置卖单。
• 任何时候最多有6个活跃订单(买单和卖单)，因此大部分资金保持可用，不会冻结在远距离订单中。

跟随上升趋势

• 当价格上涨并执行卖单时，机器人自动将其活跃订单网格上移，以继续在更高价格水平上交易。
• 通过再投资实现复利
• 启用再投资选项后，在某一水平实现的利润会自动添加到该水平的基准金额中。这意味着在同一水平上的下一个买单会稍大，随着时间的推移会产生复利效应。

原则：为了使策略按预期工作，您的账户中应有足够资金覆盖网格所有水平的买单。

示例：如果您的网格有20个水平，每个水平$10，您用于机器人操作的资金至少应为$200。

风险：价格超出网格范围

• 当价格上涨超过您的最高水平时：机器人将卖出最后一个仓位并停止交易。当价格回到指定网格范围时，机器人将恢复交易。
• 当价格下跌低于您的最低水平时：机器人将在最低活跃水平上购买仓位并停止下新买单。当价格回到指定网格范围时，机器人将恢复交易。

风险：资金不足

• 如果某一水平资金不足，机器人不会在该水平下买单。
• 当您充值账户后，机器人将在跳过的水平上恢复交易。

请记住，ATHgrid只是一个工具。您定义策略，管理资金，并完全负责您的交易决策。金融市场交易总是涉及风险。请负责任地交易！