> 帮助中心 - ContractBotX

使用指南

详细的入门教程和操作说明

安全提示

保护账户和资产安全的最佳实践

策略说明

了解各种交易策略的原理和使用方法

常见问题

快速找到常见问题的解答

联系支持

获取人工客服帮助

调试信息

系统信息和问题排查工具

使用指南

如何获取 OKX API Key

  1. 登录您的 OKX 账户(确保已完成实名认证)
  2. 点击右上角头像,选择 "账户与设置"
  3. 在左侧菜单选择 "API管理"
  4. 点击 "创建API密钥" 按钮
  5. 填写密钥名称(如 ContractBotX),设置过期时间
  6. 完成验证码验证后,点击确认创建
  7. 重要:请立即复制并保存 API Key、Secret Key 和 Passphrase,这些信息只显示一次

注意:请妥善保管您的密钥信息,切勿在公共场合或向他人透露。

API 权限配置要求

为确保 ContractBotX 正常工作,请确保 API 具备以下权限:

  • 读取账户信息 - 查看账户余额、持仓等数据
  • 读取交易 - 查看订单历史和成交记录
  • 交易权限(永续合约) - 执行开仓、平仓、挂单等操作

建议不要开通提现权限,以最大限度保障资产安全。

如何配置机器人

  1. 在设置页面选择 "API配置"
  2. 填入您的 API KeySecret KeyPassphrase
  3. 选择交易模式:实盘沙盒测试
  4. 点击 "测试连接" 验证配置是否正确
  5. 测试成功后点击 "保存配置"
  6. 在策略管理页面创建并启动您的第一个策略

如何开始交易

  1. 确保 API 配置正确且连接正常
  2. 在策略管理页面,点击 "创建策略"
  3. 选择交易对(如 BTC-USDT)和交易策略
  4. 设置策略参数(止损止盈、仓位管理等)
  5. 确认无误后,点击 "启动策略"
  6. 机器人将自动执行交易,您可以在仪表盘监控运行状态

安全提示

API 密钥保护

  • 切勿与任何人分享您的 API 密钥,包括客服人员。官方绝不会索要您的密钥信息
  • 创建专用密钥:为交易机器人创建单独的 API 密钥,不要使用主账户密钥
  • 定期更换密钥:建议每3个月更换一次 API 密钥
  • 安全存储:将密钥存储在安全的密码管理器中,不要明文保存在设备上

警告:如果密钥泄露,请立即在 OKX 删除该 API 密钥并创建新的。

IP 白名单设置

强烈建议设置 IP 白名单,限制 API 只能从指定 IP 地址访问:

  1. 在 OKX API 管理页面,点击您创建的 API 密钥
  2. 找到 "IP白名单" 选项
  3. 添加您运行机器人的服务器 IP 地址
  4. 如果您使用家庭网络,请添加您的公网 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%

实际收益需扣除开仓手续费和平仓手续费。

如何停止策略?

停止策略的步骤:
  1. 在策略管理页面找到需要停止的策略
  2. 点击策略右侧的 "停止" 按钮
  3. 选择停止方式:
    • 立即平仓:取消所有挂单并平掉所有持仓
    • 仅停止运行:保持当前持仓,仅停止新交易
    • 跟踪止损:设置跟踪止损,触发后自动平仓
  4. 确认停止操作

建议在市场出现极端行情或需要临时离开时使用"仅停止运行"模式,保留现有仓位。

连接失败怎么办?

排查步骤:
  1. 检查网络连接:确保设备可以正常访问互联网
  2. 检查 API 配置:确认 API Key 等信息填写正确
  3. 尝试直连模式:在网络设置中关闭代理,使用直连
  4. 检查代理设置:如果使用代理,确保代理服务器正常工作
  5. 检查 OKX 服务状态:OKX 官网或社交媒体可能公告服务异常
  6. 更换网络环境:某些网络可能限制对 OKX 的访问

如果问题持续存在,请联系客服并提供详细的错误信息。

联系支持

如果您在使用过程中遇到任何问题,可以通过以下方式联系我们的支持团队。我们通常在 24小时内 给予回复。

电子邮件
msyzdj@gmail.com
发送邮件描述您的问题,我们会尽快回复
微信公众号
@ContractBotX
添加好友或搜索公众号获取最新资讯

工作时间

电子邮件 24小时内
微信/公众号 工作日 9:00-18:00

调试信息

以下系统信息用于问题排查,在联系技术支持时请附上这些信息。

App 版本 1.0.0
系统时间 --
浏览器 --
屏幕分辨率 --
语言环境 --
Cookie 启用 --