CopySonar 产品文档
声呐跟单（CopySonar）帮助你发掘交易信号、评估带单员表现，并根据个性化配置创建模拟或实盘跟单。本文档系统介绍产品的核心流程、参数字段与安全边界；具体可用功能与操作权限请以页面实际显示为准。
这份文档面向第一次使用产品的测试用户：读完之后，你应该能独立完成「看懂一位带单员 → 绑定交易所 API → 创建一条模拟跟单 → 判断是否值得开实盘 → 出问题时知道先查哪里」全流程，无需反复咨询技术支持。
三条边界先说明白，后面的内容都建立在这三条之上：
- 文档描述的是产品行为，不是收益承诺。 榜单排名、韧性评分、模拟收益都不构成对未来盈利的保证。
- 文档不替代页面提示。 具体数值范围、账户额度、预检警告、任务状态都以你当前页面和服务端返回为准；页面与文档不一致时，以页面为准。
- 文档不会向你索要凭据。 任何要求你提供 API Key、Secret、Passphrase 的「客服」「文档」「教程」都不是官方行为。
文档地图
| 页面 | 适合什么时候读 | 稳定 docId |
|---|---|---|
| 入门流程 | 第一次进入产品，想弄清信号、模拟、实盘的区别 | getting-started |
| 添加交易所 API | 准备开实盘，需要把交易所账户接进来 | exchange-api |
| 创建跟单 · 字段说明 | 已经选好带单员，正在填本金、仓位与风控 | create-copy |
| FAQ | 绑定失败、没有成交、数字对不上 | faq |
| 安全 / 资金说明 | 关心资金在哪、权限边界、出事后怎么处理 | safety |
文档站内的
docId是稳定标识（例如create-copy.entry-risk），未来产品页面的问号入口会按它跳转到对应章节。中文标题可以调整，标识不会变，因此收藏链接和工单里贴的锚点长期有效。
先从概念开始：五个词看懂整个产品
第一次打开页面时，最容易混淆的是下面五个词。它们经常出现在同一屏里，但含义完全不同。
| 概念 | 它是什么 | 它不是什么 |
|---|---|---|
| 信号 / 带单员 | 你在币安公开带单数据里看到的交易者，以及他当前的开平仓动作 | 不是平台推荐的「稳赚账户」，排名靠前不等于将来盈利 |
| 模拟跟单（Paper） | 用真实行情模拟执行，不向交易所发送任何订单 | 不是实盘演练成绩，成交价、滑点与费用都与真实执行不同 |
| 实盘跟单（Live） | 通过你授权的 API，在你的交易所账户里自动下单 | 不是平台代客理财，资金始终留在你自己的交易所账户 |
| 分配本金 | 你给这条任务划出的跟单容量，用于计算仓位规模 | 不是保证金占用，也不是最大亏损额 |
| 风险预算 / 回撤止损 | 触发后停止新增风险的阈值 | 不是止损保证，也不等于自动清仓 |
理解这五个词之后，剩下的字段基本都是它们的组合。真正需要你判断的只有两件事：这位带单员值不值得跟，以及你愿意为这条任务承担多少风险。
从哪里开始
首次使用建议按顺序阅读：
- 入门流程：了解信号、模拟和实盘之间的区别。
- 添加交易所 API：仅在准备实盘时连接账户。
- 创建跟单 · 字段说明：理解本金、仓位、入场和风控配置。
如果你的时间只够看一页，请先看 安全 / 资金说明。它会告诉你资金在哪里、API 权限应该怎么开、以及出现异常时哪些操作会造成不可逆后果。
推荐的实际操作顺序如下（前两步不需要绑定任何 API）：
- 注册并登录。 内测阶段需要邀请码，可用邮箱注册（会收到验证邮件并设置密码），也可以使用 Google 登录。邀请码获取方式以注册页提示为准。
- 试扫带单员。 从信号榜单或声呐雷达进入带单员报告，先看数据时间、回撤、持仓是否公开，再决定要不要继续。
- 先跑模拟。 用同一套参数创建一条模拟跟单，观察几天它的入场节奏、漏单原因和滑点表现。模拟不需要 API Key。
- 再绑 API、开实盘。 确认参数合适后，按 添加交易所 API 绑定只读 + 合约交易权限的 Key，用较小本金启动第一条实盘任务。
- 持续观察。 实盘不是「设置完就不用管」。每天看一眼任务详情里的持仓、成交与漏单记录，比事后复盘更有用。
TODO 素材：此处补「从信号榜单到跟单任务的导航路径」录屏
遇到问题
绑定失败、没有成交、任务状态异常时，先查看 FAQ。涉及资金、权限和撤销连接，阅读 安全 / 资金说明。请勿在反馈中附带 API Key、Secret 或 Passphrase。
排查顺序建议固定为「页面提示 → 任务详情 → 交易所实际状态」三步，不要跳步：
| 现象 | 先看这里 | 常见原因 |
|---|---|---|
| 绑定 Key 失败 | API 绑定失败 | 权限不符、未开 IP 白名单、OKX Passphrase 缺失、账户非双向持仓模式 |
| 建不了实盘任务 | 为什么无法创建实盘跟单 | 未获实盘邀请、授权到期、本金额度不足、Key 校验过期 |
| 任务在跑但没成交 | 已启动但没有成交 | 无新信号、白名单或方向过滤、滑点上限过紧、追单窗口太短 |
| 数字和预期不一致 | 模拟收益、任务盈亏和账户余额为何不同 | 混用了不同口径：模拟 / 生效本金 / 保证金 / 权益 / 资金费 |
| 出现未知交易或怀疑泄露 | 异常时如何处理 | 先去交易所核对订单与授权，再处理任务与 Key |
反馈问题时请提供：发生时间（含时区）、页面上的错误文案、任务 ID，以及脱敏后的截图。不要发送完整 API Key、Secret、Passphrase、验证码或邮箱密码。官方联系方式为 support@copysonar.com。
使用前先了解风险
模拟不会向交易所下单，其结果不保证实盘收益。实盘启动后会依据信号自动下单；杠杆、滑点、流动性和极端行情可能导致全部本金损失。历史排名和评分不构成收益承诺或投资建议。
还需要接受三个现实约束：
- 执行一定会有偏差。 你的成交价与带单员的成交价之间存在延迟与滑点，这部分损耗在震荡行情里会被放大。任务详情中的「中位延迟」「平均滑点」「跟上率」就是用来量化这件事的。
- 风控是减损机制，不是保险。 回撤止损与风险预算触发后只停止新增风险并允许减仓平仓，不会替你市价清仓，实际亏损仍可能超过预算。
- 产品处于测试阶段。 系统可能出现故障、延迟、中断或数据错误；请只投入能够承受全部损失的资金，并始终保留在交易所直接管理仓位的能力。
产品不面向中国大陆用户提供服务，请确认你符合所在地法律与交易所条款后再使用。完整条款见产品内的风险提示、用户协议与隐私政策。