Freqtrade对接OKX交易所的API密钥问题解析与解决方案

问题背景

在使用Freqtrade交易框架对接OKX平台时，部分用户遇到了"API key doesn't exist"(错误代码50119)的验证问题。该问题主要出现在欧洲地区用户通过my.okx.com域名创建的API密钥上，而传统的www.okx.com域名创建的密钥则能正常使用。

技术原理分析

OKX平台近期对欧洲用户实施了区域化访问策略，导致出现了两个不同的API端点：

1. 传统端点：www.okx.com
2. 欧洲专用端点：my.okx.com/eea.okx.com

这两个端点虽然同属OKX平台，但在API实现上存在差异。当用户从欧洲IP访问时，系统会自动重定向到my.okx.com，此时创建的API密钥只能在该端点下使用。

解决方案

方案一：使用正确的exchange名称

在Freqtrade配置文件中，需要根据API密钥来源选择正确的exchange名称：

{
  "exchange": {
    "name": "myokx",  // 使用my.okx.com创建的密钥
    "key": "您的API密钥",
    "secret": "您的API密钥",
    "password": "API密码短语"
  }
}

或

{
  "exchange": {
    "name": "okx",  // 使用www.okx.com创建的密钥
    // 其他配置相同
  }
}

方案二：检查密钥配置细节

1. 确保没有在密钥前后误输入空格
2. 确认密钥是完整复制，没有遗漏字符
3. 检查IP白名单设置是否包含运行Freqtrade的服务器IP
4. 验证API权限是否包含"查看"和"交易"权限

方案三：升级依赖版本

确保使用以下版本：

• Freqtrade开发版(2024.10或更高)
• CCXT 4.4.48或更高版本

最佳实践建议

1. 创建API密钥时，注意记录是在哪个域名下创建的
2. 定期检查Freqtrade和CCXT的更新日志
3. 先在模拟交易环境中测试API连接
4. 使用freqtrade show-config命令验证配置是否正确加载

总结

OKX的区域化策略导致了API端点的分化，Freqtrade已通过支持"myokx"作为独立exchange名称解决了这一问题。用户应根据自己的API密钥来源选择正确的配置方式，并注意保持软件更新以获得最佳兼容性。

对于仍遇到问题的用户，建议先通过简单的curl命令测试API密钥有效性，再逐步排查Freqtrade配置问题。记住，平台API的稳定性是自动化交易的基础，值得投入时间确保其正确配置。