KuCoin – API导入指南
本指南介绍了如何创建 KuCoin API Key 并将其绑定到您的交易平台。
通过API连接您的KuCoin账户，您可以安全地启用自动交易、策略执行和实时账户同步。
⚠️ 开始前的重要注意事项
在创建KuCoin API Key之前，请注意：
- KuCoin的API Key系统需要Key、Secret和Passphrase——这三者必须安全保存，因为Secret一旦丢失就无法恢复。
- 具有交易权限但没有 IP 白名单的 API 密钥可能会在 30 天不活动后自动禁用或删除。
- 要有效启用 API 进行交易/机器人，您需要启用权限并可选择使用 IP 白名单。
- 确保您的帐户启用了双因素身份验证 (2FA) 来创建 API。
步骤1：登录KuCoin
1.访问KuCoin官方网站
👉 https://www.kucoin.com 2. 使用您的凭据登录（电子邮件/电话+密码） 3. 确保启用2FA（Google 身份验证器/短信）
📸 截图示例
步骤 2：导航至 API 管理
- 单击您的个人资料头像（右上角）
- 从下拉列表中选择 API 管理
📸 截图示例
步骤 3：创建新的 API 密钥
- 单击创建 API 按钮
- 在弹出窗口中输入：
- API 名称（例如，
UFOX‑KuCoin‑API） - API 密码 — 这与您的登录密码分开，将在连接 API 时使用
- API 名称（例如，
- 完成提示并继续
📸 截图示例
💡 API 密码至关重要 - 在您的平台上绑定 API 时将需要它。
步骤4：配置API权限
在API创建页面，根据您的交易需求选择合适的权限：
✅ 推荐的交易权限
- ☑️ 常规 – 允许查询市场和账户信息（只读）
- ☑️ 交易 – 允许下订单和取消订单（现货、期货）
- （可选） ☑️ 保证金交易 – 启用保证金交易
- (可选 & ⚠️) ☑️ 转账 – 实现资产转账和提现（谨慎使用）
⚠️ 只有在绝对必要且严格的 IP 白名单的情况下才应启用提款/转账权限。
步骤5：启用IP白名单（推荐）
- 将 IP 限制 切换为 是
- 添加您的交易平台提供的可信IP地址
- 单击“添加”或“保存”
具有交易权限且没有列入白名单的 IP 的 API 密钥可能会自动失去交易访问权限或在 30 天不活动后被删除。
##第六步：安全验证
设置权限后：
- 输入您的交易密码
- 输入邮箱验证码
- 输入 2FA 代码
- 确认API创建
完成后，KuCoin将显示：
- API密钥
- 密钥
- 密码（您之前输入的密码）
⚠️ 将密钥和密码保存在安全位置；它们不会再次显示。
步骤7：在您的交易平台上绑定API Key
- 在您的平台上前往账户 → API 管理 2.选择KuCoin作为交易所
- 输入：
- API密钥
- 密钥
- 密码
- 选择所需范围：
- 现货/期货/保证金
- 单击绑定/连接
步骤 8：验证 API 连接状态
绑定完成后，您应该看到：
- ✅ API 状态：已连接
- 📊 帐户平衡和同步
- 🤖 可用交易策略
常见错误及如何修复
❌ 无效的 API 或密钥
- 确保您正确复制了 API 密钥、秘密和密码
- 粘贴时删除所有空格
- 如果 Secret 丢失，请重新创建 API 密钥
❌ 权限被拒绝
- 验证所需的权限已启用（例如，贸易）
- 期货策略需要期货/衍生品权限
❌ 白名单错误
- 确保正确的平台IP位于白名单中
- 为了测试，您可以暂时禁用IP限制
安全最佳实践
- 🔐使用IP白名单来限制访问
- 🔄 频繁轮换 API 密钥
- 🚫禁用不必要的权限（尤其是提款）
- 🛑 立即删除未使用或受损的 API 密钥
常见问题解答
API 密码是什么？
这是验证 KuCoin API 请求时需要的用户定义的密码以及密钥和秘密。
我以后可以修改 API 权限吗？
是的 - 权限和白名单 IP 可以随时通过 API 管理页面更新。
API 会过期吗？
已启用交易但没有列入白名单的 IP 的 API 密钥可能会在不活动后被禁用。白名单密钥通常保持活动状态。
🎯 完成
您的KuCoin API现已成功创建并连接。
您现在可以安全地开始自动交易和实时数据同步。
更多API导入指南请查看其他交易所文档。