为什么在创建机器人后会看到 “Invalid API Key” 错误?

有时,当您在 TradeSanta 中创建机器人时,可能会看到错误 “Invalid API Key”。
在这种情况下,机器人将不会开始交易,且 “Stop Bot” 选项下方的条状栏会变红,显示相同的消息 —— Invalid API Key
那么这意味着什么,您该如何修复它?

⚙️ 导致 “Invalid API Key” 错误的原因

此错误通常意味着您的 API 密钥在创建时权限不正确 或者 连接交易所至 TradeSanta 时 IP 白名单设置不当
换句话说,由于缺失或错误的设置,API 密钥不允许 TradeSanta 访问交易数据或执行交易。
让我们根据您使用的交易所检查应注意的事项。

🟡 Binance

如果您连接了 Binance 并看到 “Invalid API Key”,请在 Binance 的 API Management 页面验证以下权限:
所需权限:
  • Enable Reading — 必须保持 on
  • Enable Spot & Margin Trading — 必须保持 on
  • Enable Withdrawals — 必须保持 off
  • Enable Symbol Whitelist 必须保持 off
  • 🔒 IP 地址限制:
    • 应设为 Restricted 并配合 TradeSanta’s IP whitelist 以增强安全性
您可以在您的 TradeSanta 账户中找到您的 unique IP list,路径为:
Your exchanges → Binance → IP List
请确保所有 IP 都已复制并粘贴到 Binance 上的 “Restrict access to trusted IPs only” 字段中。
如果白名单缺失或不正确,API 密钥将无法工作,机器人会显示 Invalid API Key
您可以在此处找到完整的逐步设置指南:
How to create API key on Binance

How to enable IP whitelist on Binance/Binance Futures


🔵 HTX (Huobi)

如果您使用的是 HTX(原 Huobi),请打开您的 API 管理 页面,并检查您的密钥权限是否符合以下要求:
所需权限:
  • 只读 — 开启
  • 交易 — 开启
  • 提币 — 关闭
  • 🌐 绑定 IP 地址: 保持为空
如果您的权限设置不正确,或者您已无法编辑它们,请创建一个新的 API 密钥并确保勾选上述正确的选项。
您可以在此处找到完整的逐步设置指南:

如何在 HTX 上创建 API 密钥


⚫ OKX

如果您正在连接 OKX,请仔细检查您的密钥权限和设置。
OKX 上出现“API 密钥无效”的常见原因包括缺少交易权限、密码短语错误或未配置 IP 白名单。
所需权限:
  • 读取 — 开启
  • 交易 — 开启
  • 提币 — 关闭
  • 🧩 密码短语: 必须与您在 TradeSanta 中输入的内容完全一致
  • 🌐 IP 白名单: 留空
您可以在此处找到完整的设置指南:

如何在 OKX 上创建 API


🧭 如果错误仍然存该怎么办

如果您的 API 密钥创建时权限或 IP 设置错误,且无法再编辑,请:
  1. 删除旧密钥(在您的交易所账户中)。
  2. 创建一个新密钥,并配置正确的权限和 IP 白名单。
  3. 重新连接您在 TradeSanta 中的交易所。
您可以在此处了解如何安全地用新 API 密钥替换旧密钥:

如何使用新 API 密钥更新访问点


✅ 最终检查清单

在重新连接之前,请确保:
  • 已启用所有必需的权限(读取 + 交易,无提币)。
  • TradeSanta 的 IP 已正确添加到白名单中。
  • 密码短语(针对 OKX)完全匹配。
  • API 密钥和密钥 (Secret) 已正确复制,没有多余的空格。
一旦所有设置都正确,请在 TradeSanta 中重新连接交易所 —— 您的机器人应该就能成功开始交易了。