修复交易所 API 密钥连接错误

当您添加交易所 API 密钥时,Freya 会先校验再保存 — 如果有问题,它会明确告诉您该修什么。本指南帮助您读懂校验结果并加以解决。(如果您的密钥当初连接正常,但机器人后来停止了,那是另一个问题 — 请参阅我的机器人为什么暂停或停止了?。)

若您是首次设置,请先阅读如何连接您的交易所;本文讲的是连接失败时该怎么办。

添加密钥时,Freya 会在保存前确认它能够连接并具备正确的权限 — 一旦校验失败,错误提示会告诉您该修什么。
“API 密钥无效 / Secret 无效”通常是复制粘贴出了岔子,或者密钥已被重新生成;“IP”类错误意味着密钥的 IP 限制与 Freya 所需的地址不匹配。
您的密钥必须具备读取和交易权限 (绝不要提现权限),并且在正确的市场 — 现货或合约 — 上启用,以与您的机器人相匹配。
OKX 密钥需要密码短语,且必须完全一致;对于合约密钥,Freya 会自动为您准备好账户,让机器人能够正确交易。
笼统的“连接失败”往往只是网络或交易所的一时抖动 — 稍后重试即可。

当密钥连不上时

添加密钥并不是盲目保存 — Freya 会先验证密钥可用且权限正确,然后才加密存储。如果有问题,错误提示会直接指向原因 — 通常是密钥或 Secret、IP 限制,或缺少某项权限。下面的章节逐一说明各类错误及其修复方法。

这是最常见的连接错误,通常也是最简单的:

解决办法: 原样重新输入密钥和 Secret,或者新建一个密钥再试。

Freya 从自己的服务器发起连接,因此密钥的 IP 设置很关键。这里有两种截然不同的情况:

“IP 地址未列入白名单” — 您的密钥设置了 IP 限制,但 Freya 的服务器地址不在允许列表中。添加 API 密钥的界面会显示需要添加的 IP 地址 (带复制按钮) — 请把它们加入交易所上该密钥的白名单。
“未受限制” — 您的密钥完全没有设置 IP 限制。出于您的安全考虑,Freya 会请您开启 IP 限制并添加它显示的地址,然后重试。

两种情况的解决思路是一样的:把密钥限制到 Freya 在弹窗中显示的 IP。

密钥连上了,但它做不了您的机器人需要做的事:

读取权限被禁用 — 请在密钥上启用读取/查看权限。
缺少交易权限 — 请启用交易权限 (现货和/或合约,与您的机器人相匹配)。
现货与合约不匹配 — 合约机器人需要启用了合约交易的密钥;现货机器人则需要现货交易权限。如果您为合约机器人添加了仅限现货的密钥 (或反之),Freya 会提示您。请确保密钥启用的市场与您正在创建的机器人一致。

请记住:Freya 只需要读取和交易权限 — 绝不需要提现权限。一个没有提现权限的密钥,正是您想要的。

OKX 需要密码短语。 创建 OKX 密钥时,您会设置一个密码短语 — 请在 Freya 中原样输入同一个密码短语。密码短语填错是 OKX 连接失败的常见原因。
OKX 合约设置。 OKX 合约交易需要特定的账户模式,Freya 会自动为您完成设置 — 您无需手动配置。
对冲模式 (合约)。 Freya 对合约账户使用对冲模式。如果您已有冲突的单向持仓,您可能会看到警告而非失败 — 密钥仍会保存,待这些既有持仓平掉后,您的机器人即可交易。
Binance 和 Bybit 不使用密码短语 — 它们没有密码短语输入框。

笼统的连接失败往往不是您的问题 — 可能只是网络一瞬间的抖动,或交易所短暂繁忙。稍等片刻再重试。如果试了几次仍然失败,请回头核对上面提到的密钥/Secret 和 IP 设置。