使用指南
详细的入门教程和操作说明
安全提示
保护账户和资产安全的最佳实践
策略说明
了解各种交易策略的原理和使用方法
常见问题
快速找到常见问题的解答
联系支持
获取人工客服帮助
调试信息
系统信息和问题排查工具
使用指南
如何获取 OKX API Key
- 登录您的 OKX 账户(确保已完成实名认证)
- 点击右上角头像,选择 "账户与设置"
- 在左侧菜单选择 "API管理"
- 点击 "创建API密钥" 按钮
- 填写密钥名称(如 ContractBotX),设置过期时间
- 完成验证码验证后,点击确认创建
- 重要:请立即复制并保存 API Key、Secret Key 和 Passphrase,这些信息只显示一次
注意:请妥善保管您的密钥信息,切勿在公共场合或向他人透露。
API 权限配置要求
为确保 ContractBotX 正常工作,请确保 API 具备以下权限:
- 读取账户信息 - 查看账户余额、持仓等数据
- 读取交易 - 查看订单历史和成交记录
- 交易权限(永续合约) - 执行开仓、平仓、挂单等操作
建议不要开通提现权限,以最大限度保障资产安全。
如何配置机器人
- 在设置页面选择 "API配置"
- 填入您的 API Key、Secret Key 和 Passphrase
- 选择交易模式:实盘或沙盒测试
- 点击 "测试连接" 验证配置是否正确
- 测试成功后点击 "保存配置"
- 在策略管理页面创建并启动您的第一个策略
如何开始交易
- 确保 API 配置正确且连接正常
- 在策略管理页面,点击 "创建策略"
- 选择交易对(如 BTC-USDT)和交易策略
- 设置策略参数(止损止盈、仓位管理等)
- 确认无误后,点击 "启动策略"
- 机器人将自动执行交易,您可以在仪表盘监控运行状态
安全提示
API 密钥保护
- 切勿与任何人分享您的 API 密钥,包括客服人员。官方绝不会索要您的密钥信息
- 创建专用密钥:为交易机器人创建单独的 API 密钥,不要使用主账户密钥
- 定期更换密钥:建议每3个月更换一次 API 密钥
- 安全存储:将密钥存储在安全的密码管理器中,不要明文保存在设备上
警告:如果密钥泄露,请立即在 OKX 删除该 API 密钥并创建新的。
IP 白名单设置
强烈建议设置 IP 白名单,限制 API 只能从指定 IP 地址访问:
- 在 OKX API 管理页面,点击您创建的 API 密钥
- 找到 "IP白名单" 选项
- 添加您运行机器人的服务器 IP 地址
- 如果您使用家庭网络,请添加您的公网 IP 地址
设置 IP 白名单后,即使密钥泄露,攻击者也无法从其他 IP 地址使用您的 API。
双因素认证 (2FA)
启用双因素认证是保护账户的重要措施:
- 在 OKX 账户设置中启用 Google Authenticator 或 手机验证码
- 务必备份 2FA 密钥,以防手机丢失
- 不要将 2FA 验证码透露给任何人
- 如发现异常登录尝试,立即更改密码并检查账户安全
策略说明
顺势策略 (Smart Dual)
原理:结合 SAR 止损指标和双均线系统,在趋势明确时顺势入场,在趋势反转时及时止损。
入场条件:
- 快速均线在慢速均线之上(做多)
- SAR 点在价格下方,确认上升趋势
- 等待回调到均线附近入场
出场条件:
- 均线死叉或 SAR 反转时平仓
- 设置固定止损比例(如 3%)
- 达到止盈目标时部分获利了结
RSI 策略 (Volume + RSI)
原理:利用成交量放大配合 RSI 超卖超买指标,在市场情绪极端时捕捉反转机会。
参数设置:
- RSI 周期:默认14,可根据币种调整
- RSI 超卖线:低于30视为超卖
- RSI 超买线:高于70视为超买
- 成交量倍数:默认2倍于平均成交量
信号逻辑:RSI 低于30且成交量明显放大 → 买入信号;RSI 高于70且成交量放大 → 卖出信号。
MACD+SAR 组合策略
原理:MACD 和 SAR 都是趋势跟踪指标,两者结合可以过滤假信号,提高入场准确性。
做多信号:
- MACD 线从下方穿过信号线(金叉)
- SAR 点从价格上方转换到下方
- 两个信号同时确认后入场
做空信号:
- MACD 线从上方穿过信号线(死叉)
- SAR 点从价格下方转换到上方
- 两个信号同时确认后入场
MACD 动量策略
原理:基于 MACD 柱状图(MACD Histogram)的动量变化,当动量由负转正或由正转负时捕捉趋势转换点。
入场逻辑:
- MACD 柱状图由负值转为正值,且连续3根递增
- 配合成交量放大确认
- 在第三根柱状图收盘时入场
优势:能够比传统 MACD 交叉更早发出信号,适合短线交易。
常见问题
为什么策略没有执行交易?
- API 配置错误:检查 API Key、Secret Key 和 Passphrase 是否正确
- 网络连接问题:检查网络设置,尝试重启或更换代理
- 账户余额不足:确保合约账户有足够的 USDT
- 策略条件未满足:查看策略参数,当前市场条件可能不满足入场要求
- 市场波动过大:极端行情下机器人可能暂停交易以避免损失
出现重复下单怎么办?
- 多个实例运行:确保同一策略只有一个实例在运行,检查是否在多个设备或浏览器标签页中打开了机器人
- 网络延迟:在高频交易时,网络延迟可能导致信号重复发送,考虑增加下单间隔
- 策略参数问题:某些策略参数组合可能导致频繁触发,检查并优化策略参数
- API 限速:OKX API 有请求频率限制,过于频繁的请求可能导致响应异常
如果发现重复下单,请立即停止策略并检查账户情况。
如何计算收益?
做多收益 = (平仓价 - 开仓价) × 持仓数量 × 合约乘数
做空收益 = (开仓价 - 平仓价) × 持仓数量 × 合约乘数
举例:
- BTC-USDT 永续合约,100倍杠杆
- 开多:价格 60,000 USDT,1张合约(= 0.001 BTC)
- 平仓:价格 63,000 USDT
- 收益 = (63000 - 60000) × 0.001 = 3 USDT
- 收益率 = 3 / (60000 × 0.001 / 100) × 100% = 500%
实际收益需扣除开仓手续费和平仓手续费。
如何停止策略?
- 在策略管理页面找到需要停止的策略
- 点击策略右侧的 "停止" 按钮
- 选择停止方式:
- 立即平仓:取消所有挂单并平掉所有持仓
- 仅停止运行:保持当前持仓,仅停止新交易
- 跟踪止损:设置跟踪止损,触发后自动平仓
- 确认停止操作
建议在市场出现极端行情或需要临时离开时使用"仅停止运行"模式,保留现有仓位。
连接失败怎么办?
- 检查网络连接:确保设备可以正常访问互联网
- 检查 API 配置:确认 API Key 等信息填写正确
- 尝试直连模式:在网络设置中关闭代理,使用直连
- 检查代理设置:如果使用代理,确保代理服务器正常工作
- 检查 OKX 服务状态:OKX 官网或社交媒体可能公告服务异常
- 更换网络环境:某些网络可能限制对 OKX 的访问
如果问题持续存在,请联系客服并提供详细的错误信息。
联系支持
如果您在使用过程中遇到任何问题,可以通过以下方式联系我们的支持团队。我们通常在 24小时内 给予回复。
工作时间
调试信息
以下系统信息用于问题排查,在联系技术支持时请附上这些信息。