FAQ

先看页面上的具体提示，再按对应情况核对。本文不代替任务详情和交易所的实际状态。

下面按「绑定 → 准入 → 执行 → 对账」四个阶段组织问题。每条都给出先查什么、常见原因、以及不该做什么。

API 绑定失败怎么办

逐项核对交易所选择、Key 与 Secret 是否配套、OKX Passphrase 是否正确；再检查读取与合约交易权限、提现和划转是否关闭、IP 白名单是否仅包含页面提供的平台出口 IP。参见 权限要求。

权限校验错误应先修正后重试。反馈时只提供错误文案和发生时间，不发送完整凭据。

按提示对照处理

页面提示（含义）	真正原因	怎么修
这个 Key 未通过交易所权限检查	交易所拒绝了只读探测请求	确认 Key 未过期、未被停用，且 Key 与 Secret 配套
这个 Key 开启了提现权限	「允许提现」处于开启状态	交易所关闭提现后重新校验（部分交易所需重建 Key）
这个 Key 开启了万向划转	资金可在账户间搬运	关闭万向划转
这个 Key 开启了内部划转	同上	关闭内部划转
这个 Key 没有绑定 IP 白名单	白名单为空	把绑定表单展示的平台出口 IP 填进白名单
这个 Key 没有合约交易权限	未勾选合约	勾选合约交易权限
这个 Key 没有读取权限	未勾选读取	勾选读取权限
账户不是双向持仓模式	交易所当前为单向持仓	在合约设置里切换为双向持仓
请检查账户备注、API Key、Secret 与 Passphrase 的格式和长度	字段为空、过短或含控制字符	Key 至少 8 字符，Secret 必填，OKX 必须填 Passphrase
已达到 N 个 Key 的额度	绑定数量到上限	解绑闲置 Key 后再绑
当前服务仅开放模拟跟单	部署侧关闭了实盘	无需处理，模拟功能可用

排查顺序

1. 先确认是不是同一对 Key/Secret。 复制粘贴时最容易串行。
2. 再看权限三件套。 读取开、合约开、提现与划转全关。
3. 然后看 IP。 白名单为空、填了多个地址、填了旧地址都会失败。
4. 接着看持仓模式。 单向持仓是最常被忽略的一项。
5. 最后看账户状态。 Key 过期、交易所风控、子账户权限不足。

不要做的事：用同一份未修改的配置连续重试；把 Key 和 Secret 贴进工单「让技术看看」；截图时保留完整 Key。

TODO 素材：此处补「API 权限校验失败提示及对应检查项，不包含凭据」截图

为什么无法创建实盘跟单

先确认已登录、账户具备实盘权限，且选择了安全合格的 API Key。查看可用本金是否读取成功、套餐或授权额度是否足够，以及预检是否返回阻止启动的错误。

如本金数据暂时不可用，使用页面的重新读取操作，不要将旧余额当作当前额度。参见 本金与仓位。

常见原因对照

页面提示	含义	你能做什么
尚未获得实盘邀请或邀请已撤销	测试阶段实盘是白名单制	联系 support@copysonar.com 申请
实盘授权已到期	授权有有效期	联系管理员续期
当前套餐不支持实盘	套餐层级不含实盘	升级套餐或先用模拟
超出实盘授权本金上限	配置本金超过授权额度	降低本金
当前实盘名额已满	出口 IP 容量达上限	稍后再试
站点暂未开放实盘	部署策略关闭实盘	无需处理，等待开放
实盘账户尚未配置风险预算	账户缺少风险预算	联系管理员配置
已停止新增风险，仍会减仓/平仓	风控已介入	看具体原因，多数需管理员核对
Key 成功校验已过期	校验结果超过 24 小时	去 Key 管理点「检查权限」复检
这个 Key 已有实盘在运行	一个 Key 只能跑一条实盘	换 Key 或先停止已有任务
账户有旧仓位，请先手动处理	检测到非本任务持仓	在交易所处理后再启动
账户保证金模式不符合要求	保证金模式与配置不一致	调整交易所设置

自查四步

1. 登录状态与套餐：确认不是未登录或额度用尽。
2. Key 状态：列表里必须是「权限校验有效」，不能是「已阻断」。
3. 本金读取：页面显示具体数字，不是 —。
4. 预检结果：如果预检返回阻止性错误，先按提示修正，不要反复点启动。

已启动但没有成交怎么办

先确认任务的模拟 / 实盘模式及当前状态，再检查是否有新的可跟随信号。入场规则、币种或方向过滤、滑点上限和追单窗口都可能影响是否跟入；不要仅因暂未成交就提高风险参数。

查看任务详情中的执行反馈，并核对交易所订单和持仓。暂停不代表已平仓，回撤阈值触发也不代表仓位已清空。参见 入场与风控。

先看漏单记录

任务详情的「执行回执」会列出每一次没有跟上的信号及原因，这是最快的确诊入口：

漏单原因	说明	通常怎么处理
追单超时 (超过追单时间窗)	信号到得太晚或窗口太短	适当放宽追单窗口，或接受漏单
滑点超限 (超过设定最大滑点)	盘口偏离超过上限	放宽滑点，或换流动性更好的币种
精度不满足交易所最小下单量	仓位太小，除不尽最小步长	提高本金或单币仓位
可用保证金不足	账户可用余额不够	降低杠杆/仓位，或补充余额
交易所接口拒绝下单	交易所侧拒绝（参数、风控、限频）	看交易所返回原因，必要时换 Key
网络断开或延时过高	执行环境异常	观察是否持续，持续则反馈
触发币种白/黑名单过滤	信号币种不在白名单	检查白名单是否过窄
触发方向过滤 (仅多/仅空)	方向不符合设置	确认方向过滤是否符合策略
触发24h成交量排名过滤	成交量排名不在范围内	调整排名阈值
带单员本金低于最低阈值	带单员权益过低	换带单员
保证金模式与设置不一致	该币种已有持仓且模式冲突	在交易所统一保证金模式

如果漏单记录是空的

说明根本没有产生可执行信号，而不是执行失败。依次确认：

• 任务状态是否为「运行中」。处于「暂停」「只平不开」「终止中」时不会开新仓。
• 带单员近期是否真的在交易。去报告页看最近活动与数据刷新时间。
• 白名单是否把带单员的主要币种排除在外。
• 是否刚创建任务：选择「仅跟之后的新开仓」时，历史持仓不会被跟入。

不要做的事

• 因为「没成交」就把滑点上限调到极大。
• 因为「没成交」就把追单窗口调到几百分钟。
• 因为「没成交」就加大本金或风险倍数。

没成交通常意味着保护机制在工作。先弄清原因，再决定是否放宽某一项。

TODO 素材：此处补「任务状态、执行反馈与当前持仓的查看位置」截图

模拟收益、任务盈亏和账户余额为何不同

模拟不会真实下单，执行价格、延迟和费用可能与实盘不同。任务配置本金、实际生效本金、保证金和交易所余额也不是同一指标。

排查时请先看清各指标的统计单位、时间跨度及费用计入方式：未实现盈亏随市价动态波动，资金费通常单列结算。若页面显示数据暂未就绪（如出现“—”），请耐心等待同步或直接核对交易所流水，切勿将其误当作零。

六个容易混淆的数字

指标	定义	常见误读
分配本金	你为任务划出的容量	当成保证金占用
生效本金	系统实际按此计算仓位的本金（可能低于配置）	忽略它已经下降
任务权益	生效本金 + 已实现盈亏 + 未实现盈亏	当成账户余额
已实现盈亏	已平仓部分的盈亏	忽略资金费未计入
未实现盈亏	当前持仓的浮动盈亏，随标记价变化	当成已到手的钱
资金费	永续合约的资金费收支，单独统计	以为已包含在盈亏里

为什么模拟和实盘差这么多

差异来源	模拟	实盘
成交价	参考价成交	真实盘口吃单，有冲击成本
延迟	不体现	网络 + 撮合 + 排队，通常数百毫秒
手续费	可能不计	按交易所费率实扣
资金费	可能不计	按持仓与费率实收实付
部分成交	通常全成	可能部分成交或未成交

所以「模拟赚 30%、实盘只赚 10%」是正常现象，反向的情况也可能出现。

数字对不上时怎么查

1. 确认口径：先分清你看的是任务维度还是账户维度。任务权益不等于交易所账户余额。
2. 确认时间：页面数据有快照时间，交易所是实时的，两者天然存在时间差。
3. 确认生效本金：本金下降会同时改变仓位规模与回撤基准。
4. 确认费用：资金费与手续费是否被单独列出。
5. 确认缺失值：显示 — 表示数据未返回，不代表 0。

如果以上都对不上，用任务 ID + 时间点 + 交易所账单联系 support@copysonar.com。不要附带凭据。

任务状态分别代表什么

状态	含义	会开新仓吗	会平仓吗
等待启动	已创建，引擎尚未接管	否	否
运行中	正常跟随信号	是	是（跟随带单员）
已暂停 / 暂停 · 只平不开	暂停新增风险	否	是（只减不增）
只平不开	风控或预算触发后的状态	否	是
终止中 / 清仓中	正在结束任务并处理仓位	否	是（按你选择的方式）
资金费结算中	平仓后等待资金费结算	否	否
清仓完成	仓位已关闭，任务收尾	否	否
启动拒绝	引擎拒绝启动，原因见提示	否	否
已停止 / 已归档	任务结束，不再自动管理	否	否

「启动拒绝」不是系统故障，通常代表准入或参数不满足，按提示修正后重建任务即可。

如何联系支持

• 邮箱：support@copysonar.com
• 请提供：发生时间（含时区）、页面错误文案、任务 ID、脱敏截图。
• 请勿提供：API Key、Secret、Passphrase、邮箱密码、验证码。

如果你怀疑凭据泄露，请先去交易所删除 Key，再联系我们。顺序很重要：撤销权限永远优先于排查原因。