连接故障排查
先搜错误提示，再按步骤修改。
输入日志里的错误码或英文原文关键词，即可查找需要在交易所后台完成的设置，以及时间、网络和下单限制检查。
!这里只搜索错误提示。请勿粘贴 API Secret、Passphrase、登录密码、私钥或助记词。
19 条解决方案
OKXWEEXAll5011140006-1044AuthenticationErrorAPI Key 无效、过期或已被删除
连接时提示 Invalid API Key、AuthenticationError 或密钥无效。
查看解决方案 ＋
5011140006-1044AuthenticationErrorAPI Key 无效、过期或已被删除
连接时提示 Invalid API Key、AuthenticationError 或密钥无效。
原因
Key 复制不完整、选错交易所环境、已经过期，或已在交易所后台被删除。
处理步骤
- 进入交易所的 API 管理，确认该 Key 仍然存在。
- 重新完整复制 Key，去掉首尾空格和换行。
- 确认软件里选择的交易所及实盘/模拟盘环境与 Key 一致。
完成后检查
重新测试连接；仍失败时，新建一枚 ATRADX 专用 Key。
OKXBitgetWEEX5011340012-1049API_PASSPHRASE_REQUIREDPassphrase 缺失或填写错误
提示签名失败、Invalid Passphrase，或要求填写 API Passphrase。
查看解决方案 ＋
5011340012-1049API_PASSPHRASE_REQUIREDPassphrase 缺失或填写错误
提示签名失败、Invalid Passphrase，或要求填写 API Passphrase。
原因
未填写创建 API 时设置的 Passphrase，或填写内容不一致。它不是登录密码，也不是资金密码。
处理步骤
- 找到创建 API Key 时自行设置并保存的 Passphrase。
- 按原值填写，注意大小写和特殊字符。
- 如果已经遗失，请删除旧 Key 并新建；交易所通常不会再次显示。
完成后检查
连接成功后应能读取余额，且不再出现签名错误。
WEEXAll40014-1051-1052PermissionDeniedAPI 未开启所需交易权限
余额可能可以读取，但下单时报 Permission Denied 或无合约权限。
查看解决方案 ＋
40014-1051-1052PermissionDeniedAPI 未开启所需交易权限
余额可能可以读取，但下单时报 Permission Denied 或无合约权限。
原因
Key 只有读取权限，没有开启当前实例所需的现货或合约交易权限。
处理步骤
- 在交易所 API 管理中编辑这枚 Key。
- 只开启当前策略需要的现货或合约交易权限。
- 保持提币及不必要的资金划转权限关闭。
完成后检查
等待权限生效后重新连接，并以小额订单测试。
WEEXAll40018-1056IP not whitelisted当前公网 IP 不在白名单
交易所返回 IP、Whitelist、白名单不匹配等提示。
查看解决方案 ＋
40018-1056IP not whitelisted当前公网 IP 不在白名单
交易所返回 IP、Whitelist、白名单不匹配等提示。
原因
API Key 绑定的是其他公网 IP，或动态网络、VPN 导致当前 IP 已变化。
处理步骤
- 查询运行 ATRADX 电脑当前的公网 IP。
- 将交易所白名单更新为这个准确的 IP。
- 如果公网 IP 经常变化，请先使用固定 IP 方案再开启白名单。
完成后检查
交易所保存生效后，在同一网络下重新连接。
OKX50101实盘与模拟盘 API 环境不一致
Key 看起来正确，但 OKX 返回 50101。
查看解决方案 ＋
50101实盘与模拟盘 API 环境不一致
Key 看起来正确，但 OKX 返回 50101。
原因
模拟盘 Key 被用于实盘，或实盘 Key 被用于模拟盘。
处理步骤
- 确认 Key 是在 OKX 实盘还是模拟盘中创建。
- 在 ATRADX 选择相同环境，或在目标环境重新创建 Key。
完成后检查
重新连接后应读取到目标环境中的账户数据。
OKX51010acctLv=1OKX 账户仍处于现货模式
永续合约下单时报 51010，提示当前账户模式不支持。
查看解决方案 ＋
51010acctLv=1OKX 账户仍处于现货模式
永续合约下单时报 51010，提示当前账户模式不支持。
原因
OKX 的账户模式为现货模式，无法提交策略所需的永续合约订单。
处理步骤
- 打开 OKX 的交易设置。
- 进入“账户模式”，切换到支持永续合约的模式。
- 确认前阅读 OKX 显示的保证金与风险说明。
完成后检查
重新连接后，检测到的账户模式不应再是仅现货模式。
OKXacctLv=4Portfolio margin组合保证金模式与双向持仓冲突
程序检测到 OKX acctLv=4，无法启用双向持仓模式。
查看解决方案 ＋
acctLv=4Portfolio margin组合保证金模式与双向持仓冲突
程序检测到 OKX acctLv=4，无法启用双向持仓模式。
原因
当前工作流下，OKX 组合保证金模式只支持单向持仓，而策略实例选择了双向持仓。
处理步骤
- 切换到支持双向持仓的 OKX 账户模式，或使用专用子账户。
- 若策略配置允许，也可以把 ATRADX 实例改成单向持仓模式。
完成后检查
启动前，交易所账户模式与实例持仓模式必须一致。
Bitget40774Bitget 单向/双向持仓模式不一致
40774：The order type for unilateral position must also be the unilateral position type。
查看解决方案 ＋
40774Bitget 单向/双向持仓模式不一致
40774：The order type for unilateral position must also be the unilateral position type。
原因
Bitget 账户是单向持仓，但订单使用了双向参数，或两者相反。
处理步骤
- 先更新到最新版 ATRADX，新版会同步 Bitget 持仓模式。
- 在 Bitget 合约设置中确认“单向/双向持仓”与实例一致。
- 若交易所拒绝切换，先平掉相关仓位并撤销未成交委托。
完成后检查
重启实例，以小额开仓单确认不再返回 40774。
OKXBitgetAll59000Position mode change failed已有仓位或委托阻止模式切换
切换持仓模式或保证金模式时被交易所拒绝。
查看解决方案 ＋
59000Position mode change failed已有仓位或委托阻止模式切换
切换持仓模式或保证金模式时被交易所拒绝。
原因
多数交易所不允许在仍有相关仓位或未成交委托时切换这些设置。
处理步骤
- 先停止 ATRADX 实例。
- 在交易所撤销该币种的未成交委托。
- 平掉或妥善处理已有仓位后，再切换模式。
完成后检查
交易所页面显示新模式后，再刷新并重新连接。
Bitget40085Unified AccountClassic APIBitget 统一账户不支持 Classic API
提示当前是 Unified Account（统一账户），暂不支持 Classic Account API；创建时也找不到“经典账户”。
查看解决方案 ＋
40085Unified AccountClassic APIBitget 统一账户不支持 Classic API
提示当前是 Unified Account（统一账户），暂不支持 Classic Account API；创建时也找不到“经典账户”。
原因
这不是客户漏选。新版统一账户使用 UTA API，与软件当前调用的 Classic 接口不匹配。
处理步骤
- 不要在同一统一账户下反复重建 Key，结果不会改变。
- 如果 Bitget 仍提供 Classic Mode 子账户，可先使用该子账户。
- 否则请联系 ATRADX 获取兼容 UTA 的版本后再连接此账户。
OKXWEEXAll5112143006ORDER_AMOUNT_TOO_SMALL下单量低于交易所最小限制
交易所提示下单数量过小、低于最小数量或不符合数量步进。
查看解决方案 ＋
5112143006ORDER_AMOUNT_TOO_SMALL下单量低于交易所最小限制
交易所提示下单数量过小、低于最小数量或不符合数量步进。
原因
配置的单笔金额换算成合约数量并按精度取整后，低于该币种的最小下单量。
处理步骤
- 在交易所查看该币种最小下单量。
- 谨慎提高固定保证金或单笔金额。
- 不要只为绕过最小限制而盲目加杠杆；先评估爆仓风险。
完成后检查
计算后的数量必须同时满足最小值和数量步进。
WEEX43007下单量超过交易所最大限制
WEEX 下单返回 43007，提示数量超过最大限制。
查看解决方案 ＋
43007下单量超过交易所最大限制
WEEX 下单返回 43007，提示数量超过最大限制。
原因
单笔数量超过该币种或当前账户级别允许的上限。
处理步骤
- 在 WEEX 查看该币种的单笔数量上限。
- 降低固定保证金、杠杆或单笔下单金额。
完成后检查
用处于交易所允许范围内的数量重试。
OKXWEEXAll5100842002InsufficientFunds可用保证金或下单额度不足
账户仍有余额，但新订单因可用保证金或下单额度不足被拒绝。
查看解决方案 ＋
5100842002InsufficientFunds可用保证金或下单额度不足
账户仍有余额，但新订单因可用保证金或下单额度不足被拒绝。
原因
已有委托、仓位、手续费预留或当前下单规模占用了可用保证金。
处理步骤
- 在交易所检查已有委托和仓位。
- 撤销不需要的委托，或降低策略下单金额。
- 确认策略总风险后，再决定是否补充保证金。
完成后检查
应以交易所显示的“可用余额”而不是“总权益”判断是否足够。
WEEX-3313设置杠杆超过交易所允许上限
WEEX 在设置杠杆或下单时返回 -3313。
查看解决方案 ＋
-3313设置杠杆超过交易所允许上限
WEEX 在设置杠杆或下单时返回 -3313。
原因
所选杠杆超过该币种、当前仓位规模或账户等级允许的上限。
处理步骤
- 查看交易所对该币种显示的最大杠杆。
- 把 ATRADX 杠杆设置降低到允许范围内。
完成后检查
重新连接并确认交易所已接受新的杠杆设置。
AllSPOT_BALANCE_INSUFFICIENT现货基础币或计价币余额不足
现货买入或卖出时提示可用资产余额不足。
查看解决方案 ＋
SPOT_BALANCE_INSUFFICIENT现货基础币或计价币余额不足
现货买入或卖出时提示可用资产余额不足。
原因
买入需要可用 USDT 等计价币，卖出需要可用 BTC 等基础币；被委托占用的资金不属于可用余额。
处理步骤
- 检查现货账户的“可用余额”，不要只看总余额。
- 撤销多余委托，或将所需资产转入现货账户。
- 必要时降低单笔下单金额。
完成后检查
确认所需币种位于 API Key 所属的同一账户中且可用。
Binance-4411TradFi PerpsBinance 尚未签署 TradFi 永续协议
Binance 返回 -4411，要求完成 TradFi Perps 问卷或协议。
查看解决方案 ＋
-4411TradFi PerpsBinance 尚未签署 TradFi 永续协议
Binance 返回 -4411，要求完成 TradFi Perps 问卷或协议。
原因
所选产品需要先签署相关协议，或者当前账户/地区暂不支持该产品。
处理步骤
- 登录 Binance 网页或 App，进入 TradFi Perps 入口。
- 若入口可用，完成要求的问卷和协议。
- 若没有入口，请改用普通加密货币永续合约，或联系 Binance 确认地区/账户限制。
OKXWEEXAll501024000540008Timestamp error电脑时间或时区不同步
鉴权时提示 Timestamp、请求过期或服务器时间不一致。
查看解决方案 ＋
501024000540008Timestamp error电脑时间或时区不同步
鉴权时提示 Timestamp、请求过期或服务器时间不一致。
原因
电脑系统时间与交易所服务器时间偏差过大。
处理步骤
- 在操作系统中开启“自动设置日期与时间”。
- 确认时区正确，并立即同步系统时间。
- 同步完成后重启 ATRADX。
完成后检查
系统时间应与互联网标准时间只相差几秒。
BinanceOKXWEEX-100350011-1059Rate limit请求限频或 IP 临时封禁
提示请求过于频繁；Binance -1003 还可能给出 IP 解封时间。
查看解决方案 ＋
-100350011-1059Rate limit请求限频或 IP 临时封禁
提示请求过于频繁；Binance -1003 还可能给出 IP 解封时间。
原因
在交易所限频周期内请求过多，反复重启程序也可能进一步触发限制。
处理步骤
- 停止反复重启或重连实例。
- 等待交易所提示的限频/封禁时间结束。
- 限制期间请直接在交易所检查并管理未成交委托。
完成后检查
限制解除后只重启一次，并观察是否再次出现请求突增。
AllNETWORK_ERRORConnection timeout当前网络无法访问交易所 API
连接超时、DNS 失败，或程序持续提示 NETWORK_ERROR。
查看解决方案 ＋
NETWORK_ERRORConnection timeout当前网络无法访问交易所 API
连接超时、DNS 失败，或程序持续提示 NETWORK_ERROR。
原因
本地网络、防火墙、代理/VPN 路由或地区可用性阻止了对交易所 API 的访问。
处理步骤
- 先确认该交易所在用户所在地区可正常提供服务。
- 检查防火墙、代理和 VPN，使用交易所允许且稳定的网络线路。
- 不要绕过当地法律或交易所的地区限制。
完成后检查
在同一稳定网络下重新执行连接测试。