合约跟单
功能简介
合约跟单是一款由 ChainUp 自主开发，一键复制交易员合约开仓平仓行为，并公开交易员实盘战绩的合约运营工具；
通过合约跟单，可极大降低用户的合约交易门槛，通过筛选优质的交易员，还可以享受正确交易策略及判断带来的资产增值；
用户使用合约跟单无须交付任何费用，取消跟单后，跟单期间盈利会按 kol 配置的比例进行盈利分成，以此来激励优秀交易员不断优化交易策略，提高盈利率；
系统角色
带单人(下文简称为 KOL)：
将自己的合约交易策略同步给跟单人，可以赚取跟单人的分润奖励；
跟单人（普通用户）：
复制跟随 KOL 的成交记录进行开仓平仓，若账户余额花光，则不再跟单；
可以跟随多个 KOL，跟单后，跟单资金进入独立的子账号；
跟单逻辑说明
KOL正常进行合约交易，一旦KOL交易成功，系统会立即通知跟单系统；
跟单系统判别当前KOL是否有正在跟单的用户，如果有则按照跟单用户的配置，使用跟单用户的子账号进行对应的跟单操作（定时任务每3秒执行一次）；
跟单成功后，有定时脚本不断从合约系统抓取用户仓位相关数据更新到跟单系统，数据包括持仓均价、盈亏金额、盈利率等等（定时任务每2分钟执行一次），跟单系统会基于这些基础数据计算并更新KOL的带单概况相关信息（包括盈利率、盈利金额、跟单人数等），（定时任务每5分钟执行一次）；
跟单用户可以提前配置止盈止损，跟单系统根据用户的配置挂止盈止损单，如果下单失败则定时任务会一直下单直到成功（定时任务每5秒执行一次）；
如果跟单用户取消跟随，则跟单用户的仓位将进行市价平仓，通过定时任务执行（定时任务每10秒执行一次）；
跟单用户结束跟单后（已平仓），如果盈利大于0，则按照约定的KOL分成比例，将佣金结算给KOL（定时任务每30秒执行一次）；
如果跟单执行出现异常（比如网络连接错误），会有定时任务每5分钟执行一次，将跟单资金退回到母账号；
用户和KOL跟随关系说明
跟单后，用户和 KOL 建立跟随关系；
用户在我的跟单中-进行中选择取消跟单-只平此仓，当前仓位按市价平仓，不会取消跟随关系，之后仍会跟随KOL进行操作；
用户在 KOL 详情页/我的跟单中对KOL取消跟单，系统会取消跟随关系，并且会将所有仓位进行市价平仓；
用户若设置了止盈止损，在计划委托触发后，系统会自动取消跟随关系；
后台对kol进行禁止带单，会取消跟随关系；
KOL爆仓并不会解除跟随关系；
后台基础配置
Web专题页配置
商户可以在这里配置合约跟单Web界面的相关信息，配置路径：后台-增值服务-合约跟单-KOL列表-专题页配置，如下图所示：
字段说明：
主标题：Web的banner图的主标题，必填，最大50个字符；
副标题：Web的banner图的副标题，必填，最大100个字符；
按钮文字：按钮展示的文字内容，必填，最大10个字符；
按钮跳转链接：按钮点击跳转的目标地址，必填，最大500个字符，点击后从新窗口打开；
背景图：Web的banner图，需要是一张无文字的图片；
推荐配置：
主标题
合约跟单
Copy Trade
副标题
跟单顶级交易员，获取高额收益
Follow top traders for high ROI
按钮文字
了解更多
Tutorial
添加KOL
合约跟单的核心是找到胜率较高的带单人，从而吸引普通用户进行跟单操作。带单人都是通过私下跟交易所进行联系和确认，只能通过管理员在后台手动添加。
路径：后台-增值服务-合约跟单-KOL列表-新增KOL，如下图所示。
字段说明：
KOL-UID：提前确认好带单人的UID，必须输入有效UID；
盈利分成比例(%)：填写1~99中间的数字，推荐配置10（代表10%），即跟单人如果盈利将会从盈利部分分润10%作为带单人奖励（未盈利则不会分润奖励）；
单人最小跟单金额(USDT)：跟单人最小跟单金额，主要是设置一个门槛，避免太小的散户参与跟单；
单人最大跟单金额(USDT)：跟单人最大跟单金额，主要为了避免大户占用过多额度；
总带单金额额度(USDT)：当前所有跟单用户的总跟单金额，超过此金额后，新跟单用户不能继续跟此带单人；
带单人数限制：KOL同时可带单的最大人数，超过限制后用户端会显示“满员”，新用户无法继续跟单；
带单币对：选项为当前系统支持的全部合约交易对，可多选，选中即代表带单人可以带的合约币对（其他合约交易对带单人仍可自行交易，只是跟单人无法跟单）；目前带单币对需要研发执行SQL语句进行添加，不会自动识别合约交易启用状态的币对。
跟单黑名单：添加不允许跟此KOL的用户，多个 uid 以“,”区分，例如 10001,10002；
带单数据：KOL的一些带单信息汇总
KOL列表
添加完KOL后，商户可以通过KOL列表查看带单人的基本情况，包括账号信息，跟单人数、跟单金额、带单收益等，如下图所示。
操作说明：
编辑：已添加的kol弹窗进入kol编辑页；
禁止带单：弹窗二次确认，确认后前台列表不再显示此kol（已跟随仓位仍跟随操作平仓/用户主动平仓），【禁止带单】后按钮变为【恢复带单】，恢复后前台则显示；
置顶：前端KOL列表的默认排序是按照收益额（从高到低），收益额相同则按照累计收益率（从高到低）排序。如果KOL设置了置顶，则优先展示置顶的KOL。用户正在跟随的KOL按照时间从近到远排序。顺序：已跟随>系统置顶>系统排序。
跟单查询
默认显示所有跟单订单，按跟单开始时间由近及远排序，如下图所示。
字段说明：
开始跟单时间：母账号完成跟单下单操作的时间，精确到秒（非子账号开仓时间）；
跟单结束时间：子账号开仓订单跟单结束的时间（完全平仓时间），也是佣金结算时间；
跟单用户ID：母账号(操作跟单服务)的本平台UID；
子账号ID：跟单人实际开仓的本平台UID（用户看不到）；
带单人昵称|KOL UID：带单人相关信息；
跟单金额：进行跟单操作时划转到子账号的跟单币种金额，读取该币种的精度；
分成比例：该带单人的跟单盈利分成比例，数据来源交易所管理员添加KOL时的配置，每笔订单可以不同（管理员后台修改分成比例）；
盈利已分成金额：跟单盈利分成金额，计算公式：MAX(盈亏金额*盈利分成比例，0)；
止盈比例：跟单人在跟单设置时配置的参数，盈利超过设置的比例后自动平仓，同时取消跟随关系；
止损比例：跟单人在跟单设置时配置的参数，损失超过设置的比例后自动平仓，同时取消跟随关系；
跟单状态：
跟单中：1.子账号已开仓,但未平仓/用户主动跟单的状态；2.母账号已开始跟单，但子账号未开仓的状态；
已结束：1.子账号已开仓且完全平仓的状态；2.子账号已开仓，用户取消跟单，系统自动平仓；3.子账号未开仓，用户主动结束跟单
盈亏金额、成交记录：需要到合约后台进行查看；
前端页面说明
Web端显示配置
在Web版页面增加【合约跟单】模块入口，如下图所示
后台路径：公共管理-网站配置-PC主题配置-首页导航-配置，添加合约跟单入口，如下图所示。
点击【修改】按钮，在详情页添加合约跟单模块相关信息，如下图所示：
标题类型：现货
访问路径：/koltrade
APP端显示配置
在app版首页增加【合约跟单】模块入口，如下图所示。
后台路径：公共管理-网站配置-APP首页应用-添加，如下图所示。
点击【添加广告】按钮，在详情页编辑【合约跟单】模块信息，如下图所示：
显示位置：功能区
图片标题：合约跟单
访问路径：https://m.xxxx.com/zh_CN/app_operation/kolTradersListNew?isAp
p=1（将您的交易所域名替换上面链接中的红色部分，不同语言需修改对
应蓝色部分的链接：中文→zh_CN，英语→en_US，日语→ja_JP，韩语
→ko_KR）
语言：设置APP在哪种语境下展示该icon
类型：安卓、ios需要分开设置；
下图表示在安卓app中文下展示此icon，显示名称为“合约跟单”
合约跟单相关页面
用户可以在交易员列表页根据收益额、收益率、胜率、跟单人数四个维度筛选合适的带单人，如下图所示：
Web版KOL列表界面：
APP版KOL列表界面：
首次进入合约跟单界面时，会有风险提示。点击【我已知晓】后下次进入将不再提示。
点击KOL可以查看交易员的带单概况，以及KOL的历史带单数据，如下图所示：
KOL列表/带单概况 字段说明：
以下数据每五分钟更新一次：
累计收益率：开启跟单功能后，KOL总收益/仓位保证金之和，保留两位小数；单个仓位保证金 = 合约数量 x 入场价格 / 杠杆；
近2周交易胜率：开启跟单后，最近14天（含当日）所有"已平仓+持有中"仓位中，仓位实际已实现盈亏大于0的仓位数量占仓位总数量的百分比，范围0.00%～100.00%，保留两位小数；
总收益(USDT)：第一次成为KOL后，该KOL用户所有收益（收益通过定时任务每2分钟查询合约仓位，拉取总收益，收益包括已平仓位盈亏+未平仓的收益）；
交易胜率：开启跟单后，所有"已平仓+持有中"仓位中，仓位实际已实现盈亏大于0的仓位数量占仓位总数量的百分比；
交易笔数：开启跟单后，所有开仓+平仓行为总和（未平仓也计算）；
当前跟随：已跟单人数/后台配置的最大跟单人数；
累计跟单人数：开启跟单后，用户跟随此KOL进行跟单操作的总数，一个用户可以有多条记录，只增不减。具体算法：用户开始跟单的时候算一人次（此时由于KOL没开仓，跟单人实际没有开始跟单），等KOL交易了，跟单人数还会再加一人次（实际有多少正在跟随的人数加多少次）；
交易频次：开启跟单后，统计最近7天（含当日）开仓+平仓行为的总数；
额度限制：该KOL剩余可跟随的金额（后台可以为此kol配置跟单额度），额度限制=最小跟单金额～min(剩余可跟额度，后台配置的最大金额)
按钮：展示优先级为 已跟单>满员>立即跟单，如果已跟单人数=最大跟单人数则显示满员。未登录点击按钮跳转到登录页面。
历史带单-收益率：
多仓：[(平仓均价-开仓均价)/开仓均价]*杠杆倍数*100%
空仓：[(开仓均价-平仓均价)/开仓均价]*杠杆倍数*100%
选择合适的带单人，点击立即跟单，可以跳转到跟单设置界面，如下图所示。
跟单设置界面字段说明：
跟单合约：后台管理员添加KOL时选择的合约币对，跟单人可以选择跟随哪些合约币对的交易；
跟单模式：固定金额跟单、按比例跟单（默认只有固定金额跟单，按比例跟单需要单独开启，方式是：后台KV配置中搜索“isOpenScale”，改成1）；
跟单金额：目前只支持USDT跟单，最大最小值读取该KOL配置的最小值最大值、若未配置，默认最小值为10USDT，最大值为1000USDT，开始跟单后，系统会将跟单金额从现货-可用账户划转到子账号中作为保证金跟随带单人交易；
按固定金额跟单：与KOL的交易金额保持一致；
按比例跟单：与KOL的交易比例保持一致，跟单价值=跟单子账号当前余额 * 杠杆倍数 * KOL开仓比例，其中：
KOL的开仓比例 = KOL本次下单金额 / KOL开仓前余额；
KOL开仓前余额 = KOL当前余额 + 本次的开仓保证金 + 手续费
止盈止损：超过对应比例后，会自动进行平仓操作，触发止盈止损会自动取消跟随关系，如果用户的止盈止损挂单失败，会有定时任务每5秒重试挂单直到成功；
止盈：
开仓是多头：X=持仓均价+[跟单金额*设定止盈百分比/持仓数量*合约面值]
开仓是空头：X=持仓均价 -[跟单金额*设定止盈百分比/持仓数量*合约面值]
挂单方式：计划委托
止损：
开仓是多头：X=持仓均价-[跟单金额*设定止盈百分比/持仓数量*合约面值]
开仓是空头：X=持仓均价+[跟单金额*设定止盈百分比/持仓数量*合约面值]
挂单方式：计划委托
预估强平价（逐仓条件下的正向合约预估平仓价）：
多仓 Lp=[Hp *Vol *S*(1+R)-(IM-MM)]/(Vol * S)
空仓 Lp=[Hp *Vol *S*(1-R)+(IM-MM)]/(Vol * S)
Lp：强平价格 ；Hp：持仓均价；Vol：持仓量（张） ；S：合约面值；IM：起始保证金；MM：维持保证金 R：吃单手续费率
我的跟单汇总数据说明：
跟单总金额：所有跟单总金额之和（跟单设置界面输入的跟单金额，并非实际跟单金额），如果跟单后KOL未开仓时用户主动取消跟单，该跟单金额仍然会被统计，保留两位小数。
收益额：所有已结束的跟单盈亏金额累加，其中盈利金额是扣除了KOL分成后的盈利，下面跟单记录中的盈亏金额是合约仓位的整体盈亏，是未扣除KOL分成的收益，不能直接用跟单记录的盈亏金额进行加总进行对账。
收益率：显示用户跟单总的收益率，算法为：跟单收益额/跟单总金额，正数绿色,负数红色，带“+””-“号，保留两位小数；
单笔跟单记录字段说明：
币对：显示这笔跟单的交易币对；
全仓/逐仓&杠杆&方向：显示这笔跟单实际是全仓下单还是逐仓下单，开仓方向及杠杆倍数，这些数据都与KOL当时开仓的合约订单保持一致；
带单人：显示该笔跟单的带单人昵称，最多显示20个字符，超过后显示...
持仓均价avg_cost_px：查询仓位的均价，通过接口查询，价格按照合约币对的价格精度展示；
预估强评价：查询仓位的强平价格接口，价格按照合约币对的价格精度展示；
盈亏金额：该笔跟单查询时的已实现盈亏+未实现的盈亏【通过合约仓位接口查询】，盈亏扣除包括交易手续费、资金费用和平仓盈亏，但没有扣除给KOL的盈利分成，所以我的跟单的总收益额实际比所有跟单记录的盈亏金额总和要小；
收益率：该笔跟单查询时的收益率,算法为使用盈亏金额除以跟单金额*100%，保留两位小数，动态变化，可正可负。
已下单金额：实际跟单已使用的金额，只统计该仓位开仓和加仓的总保证金，小数点读取币种合约小数点，usdt为4位。
总跟单金额：用户跟单设置时输入的金额（并不是实际下单的金额），当一笔跟单结束后，kol再次下单时若跟随此kol的跟单子账号账户余额不足，则不再跟单，退资产回母账号。
操作-跟单详情：点击跟单详情跳转到详情页面，可查询该笔跟单对应的开平仓记录；
操作-取消跟单：取消跟单有两种方式：1）取消跟随关系后，当前仓位按市价平仓，以后不再跟随此KOL；2）只平此单则当前仓位按市价平仓，但仍保持与带单人的跟随关系，以后还会跟随开仓。
跟单详情界面字段说明：
已下单：
进行中的跟单：
逐仓跟单：已下单金额 = 持仓保证金
全仓跟单：已下单金额 = 开仓价格 * 仓位数量 * 面值 / 杠杆倍数
平仓后的跟单：（已平数量大于0）
已平数量大于0：已下单金额 = 平仓数量 * 面值 * 开仓价格 / 杠杆倍数
已平数量等于0：已下单金额 = 跟单金额
KOL个人信息：
头像：点击上传头像打开上传头像弹窗；
昵称：默认脱敏显示KOL注册时的手机号或邮箱，KOL可以在个人中心中设置对外展示的昵称；
个性签名：个性签名最多可以输入30个字符，不支持多语言；
分享赚佣金配置：配置后，KOL可以从自己的跟单收益中拿出一定比例给分享人作为奖励，这样分享人将更有动力将KOL推荐给新用户，让新用户跟随KOL交易
带单概况界面字段说明：
带单总金额(USDT)：所有跟随此kol的用户跟单总金额（折算成USDT），包括进行中、待下单、跟单中的跟单金额，保留两位小数，用户多次下单分别计算；
收益率：同KOL列表中的“累计收益率”，计算公式：开启跟单功能后，KOL总收益/仓位保证金之和，保留两位小数；单个仓位保证金 = 合约数量 x 入场价格 / 杠杆；
盈利净值：所有跟随过此kol且已结束跟随的用户的跟单已实现盈亏的总和，按实时汇率折算成usdt显示，保留两位小数；
跟单人数：跟随此kol的人数，每人按一次计算，用户跟随后取消跟随仍计算在内。
今日预估收益：KOL今天预计的带单收益，是每一笔带单收益的总和，单笔带单的收益 = 跟单用户已平仓位的盈利金额 * KOL跟单分成比例 *（1-KOL分享抽佣比例），换算成USDT，其中跟单用户已平仓位必须是平仓时间在今日且跟单盈利大于0的仓位；
昨日收益：统计昨日已结算的分佣之和，保留两位小数；
当前跟单总额：当前所有跟随此kol进行开仓的待下单、进行中的总金额，按实时汇率折算成USDT的汇总；
昨日跟单总额：统计昨天跟单成功用户的跟单金额，统计折算成usdt，保留两位小数
当前跟单人数：当前成功跟随此kol跟单的用户数（状态为进行），一个用户记录一次；
昨日跟单人数：统计昨天跟单成功的人数，一个用户记录一次；
当前跟随订单：当前跟随此kol状态为待下单和进行中的订单数量；一个用户可能有多笔跟单订单；
收益明细界面字段说明：
累计佣金(USDT)：是所有已结算佣金的汇总，保留两位小数；
佣金明细：跟单人平仓后如果有正向收益，会通过定时任务（30S一次）自动按KOL的分成比例进行结算并发放给KOL，同时产生一条佣金明细，明细按时间倒序展示；跟单佣金与保证金币种一致，如果币种有币种别名则使用币种别名，小数点均保留4位，超过4位直接舍掉；
跟随明细界面字段说明：
当前跟单人数：展示当前跟随此kol跟单的人数，一人有多笔订单只记录一次，仅统计跟单状态为进行中和待下单的跟单人数；
跟单金额（总）：状态为进行中和待下单的总跟单金额，按统计时汇率折算成USDT，保留两位小数，单位为USDT；
跟单金额：单个跟单用户的状态为进行中和待下单的总跟单金额，按统计时汇率折算成USDT，保留两位小数，单位为USDT；
分成金额：根据KOL分成比例，计算跟单状态为进行中的仓位的盈利金额对应的预计分成的金额，统计折算成USDT，保留两位小数，分成金额只计算每笔跟单大于0的部分进行累加；
Last updated
