现货交易
为方便交易所自助完成上币,满足更多样、更便捷、更及时的上币需求,系统开放了自动化上币功能。自动化上币的工作流程为:
平台运营方根据计划上新的币种(钱包必须要支持该币种);
在“币对配置”模块中依次配置各币对(详见 币对配置);
设置币对交易手续费,币种提币手续费;
通知运维,对所有新配币对依次起撮合;
随时在“币种管理”或“币对配置”目录下修改相应参数和开关,以应对紧急情况或满足即时需求(如需要)。
三方币种配置
交易所目前支持ChainUp-Custody、ChainUp-MPC,Fireblocks三种第三方钱包。如果商户选择使用第三方钱包,需要完成以下操作,如果使用交易所自建钱包,可跳过此步骤。
第三方钱包参数配置
商户需要按要求将交易所需要的参数提供给ChainUp项目经理,并由ChainUp运维团队协助更新钱包相关的配置文件(如果商户自己运维,可以将参数提交给自己的技术团队处理)。
同时ChainUp团队也会将第三方钱包所需要的参数提供给商户,由商户配置在第三方钱包后台中。具体参数说明如下:
ChainUp-MPC
● APP ID
● ChainUp RSA公钥
创建API时需要:
● 绑定IP地址
创建API后需要补充:
● 交易状态通知地址
● Co-Signer接口地址
● Co-Signer RSA公钥
● 客户系统 RSA公钥
三方钱包需要的参数可从ChainUp项目经理、运维人员处获取。
添加三方币种
添加三方币种的目的是将第三方钱包支持的币种信息添加到交易所内,以确保用户充提币时,交易所币种与第三方钱包的币种一致。
点击【添加】按钮,可以选择对应的钱包以及币种,确认添加后系统会自动将第三方钱包的币种信息同步添加至交易所中,如下图所示。
注意:
下拉选项仅展示商户在第三方钱包中已开通但未添加至交易所的币种,已添加的币种不会显示,这种情况提示暂无数据是正常情况;
交易所每分钟自动从第三方钱包获取开通的币种及币种信息,如果下拉选项未找到相应币种,可稍后重试;
如果只配置了一个第三方钱包,则添加弹窗中不显示【钱包类型】字段;
添加成功后,商户可以在列表中看到不同钱包类型的币种信息,如下图所示。
字段说明:
币种 : 第三方钱包中的币种标识(如ERC20的USDT,在Custody钱包中的币种名称是USDTERC20);
钱包类型:该币种所属的第三方钱包,不同钱包的币种名称可能会重复;
合约地址: 币种的合约地址,主链币可为空,代币必须有合约地址;
合约精度: 币种的合约精度, 从第三方钱包中获取;
充值确认数:用户充值后,经过指定数量的区块确认后,交易所会更新用户资产,Custody&Custody-MPC会提供确认数,Fireblocks钱包不需要(Fireblocks通知交易所资金已到账,交易所即会更新用户资产)
主链币名称: 该币种对应链网络的主币名称(也是gas费币种);
是否支持Token币:如果是主链币就支持Token币,代币就不支持,Fireblocks未返回该字段的内容,需要商户添加交易所币种时自行配置;
是否支持Memo:如果支持Memo标签就显示支持,否则显示不支持,Fireblocks未返回该字段的内容,需要商户添加交易所币种时自行配置;
地址校验规则: 用户提币时,系统会校验提币地址是否满足此规则,主链币需维护地址校验规则, 代币则与主链币保持一致,Fireblocks未返回该字段的内容,需要商户添加交易所币种时自行配置;
更新时间:最近一次更新币种信息的时间
注意:
商户点击【币种更新】按钮,系统将检查所有已添加的Custody&Custody-MPC的币种,将币种信息更新到最新,如果币种信息没有发生变化,则不会更新“更新时间”字段;
Fireblocks钱包暂不支持币种更新功能;
后续如果第三方钱包币种的信息发生变化, 系统不会自动更新, 需要管理员在这个页面手动更新;
添加完成后,点击「交易管理-现货交易-币种配置-添加币种」,钱包类型选择对应的第三方钱包,您可以在「三方币种」下拉选项中看到刚才添加的第三方币种,如下图所示。
选择「三方币种」后,会将刚才在「三方币种配置」中填写的币种信息自动显示到此页面,确认币种信息无误后,点击保存即可添加第三方钱包的币种到交易所。
「三方币种」下拉选项仅展示尚未在交易所添加的第三方钱包的币种,已添加的币种(完成币种配置),则不会在下拉列表中显示。
币种配置
币种配置是对交易所内各个币种和它们的重要配置参数的编辑区,界面如下图。列表中显示的是已加入系统中的各个币种的配置情况。
点击列表上方的【添加】或列表右侧的【编辑】,进入币种编辑页面。
字段说明:
钱包类型:默认为“交易所钱包”类型,选择此类型可继续按照币种配置,选择“Custody钱包”类型,请先完成Custody币种配置。
三方币种:如果钱包类型选择了Custody钱包,需要选择当前币种对应的Custody钱包中的币种名称(建立对应关系),已添加对应关系的币种不会在下拉框中展示。
币种类型:下拉菜单选择主链币(新建币种是主链币)或 XXX(新建币种是代币,选择对应的主链币”。
币种简称:输入大写字母简称,如BTC、USDT,此简称作为币种的唯一标识,提交后不可修改。
币种别名:选填,如果有别名,用户端优先展示币种别名。
合约地址:主链币不用填,若是代币则需要填写,地址需要去区块浏览器上查询。
合约精度:主链币不用填,若是代币则需要填写,可在区块浏览器上查询。请注意,此处需填写小数位数,如“4”代表精确到0.0001。如果配置的合约精度与钱包侧配置的币种合约精度不一致,会导致提现失败。
Address查询链接:区块链浏览器地址前缀,用户点击提币地址如。
TXID查询链接:充值信息、提现信息。
是否支持Token币:添加的是主链币时,需要选择【是】,配置后在【币种配置-币种类型】中可以看到该主链币的选项。
地址校验规则:用户填写提币地址时,会根据此处配置的校验规则进行初步检验。
标签类型:根据实际情况配置提币时是否需要Memo标签。
对btc汇率计算公式:输入币对汇率和该币对的计价货币与三大币种汇率转换公式,用“|”分隔,例如:|AAAHT|*|HTBTC|。请注意,只有当该币种不出现在BTC、ETH、USDT交易区时,才需填写。
币种logo路径:所有用户端展示币种logo的地方统一按此处配置的url展示,不配置则展示默认logo。
是否开启:“是”则前台币种列表可见,“否”则不可见。
是否开放充值:“是”则该币种在前台可以充值,“否”则不能。
是否充值到锁仓:开启后用户充币到账后,资金直接转入用户的现货锁仓账户,多用于平台币等特殊币种。
是否开放提现:“是”则该币种在前台可以提现,“否”则不能。
是否为计价货币:“是”则可以开放该币对的交易区,“否”则只能设置与其他计价货币组成交易币对,在对应计价货币的交易区进行交易。
单次提现最小值:每一笔提现的最小额度。请注意,需大于该币种的最小矿工费。
单次提现最大值:每一笔提现的最大额度。
单日提现最大值:每天0:00-24:00内总提现量的最大额度。
单日提现最大值(未认证):未实名认证用户的单日提现最大限额,不允许未认证用户提现则填“0”。
排序:该币种在前台页面“资金管理”模块中的排序,需填写阿拉伯数字。请注意,各币种排序按照设置数字从小到大顺次排列,若数字相同,则按照时间顺序排列。
显示精度:用户资产列表等界面展示币种的小数位精度,8代表展示到小数点后8位。
单次充值最小值:每一笔充值的最小额度,低于最小值则不会增加到用户资产账户。
充值到账确认数:入账需要达到的到账确认数,一般为30左右。钱包充值后,需要达到该设定值的确认数,所充币才能划转到业务层的账户上。若没到达到该设定值,则所充币只能到达业务层的冻结账户中。
仅对持仓用户显示:开启后,对未持有该币种的用户,资产列表中会隐藏该币种。想要进行单个币种的配置,首先需要确保“根据持仓隐藏币种”的总开关为已开启状态。配置方式为:现货后台-KV配置“only_hold_show_open”,配置值为1。
币种标签:配置后在行情、交易等页面的币种/币对名称处会显示对应的标签。
三大币种汇率为默认值,自动填写,只有不在三大交易区的币种需要手动填写。
点击【确认】,现货交易区、场外交易区分别发布该币种信息到沙盒环境(并未真正生效)。此时“发布上线”按钮为红色状态。确认本次修改的信息无误后,点击【发布上线】,按钮变为蓝色表示此次为修改已经生效(同步到前台系统)。
币对配置
币对配置是对交易所各交易区内每一个交易币对的重要配置参数的编辑区,界面如下图。列表中显示的是已加入系统中的各个交易币对的配置情况。
点击页面左上角【添加】或右侧的【编辑】,进入币对编辑页面。
编辑说明:
基准货币:该币对的被交易货币,写在币对前面。
计价货币:该币对的计价货币,写在币对后面。
限价交易最小价:限价委托允许挂单的最小价格,以计价货币为单位。
限价交易最小量:限价委托允许挂单的最小数量,以基准货币为单位。
市价买最小价:市价委托允许挂单的最小价格,以计价货币为单位。
市价卖最小量:市价委托允许挂单的最小数量,以基准货币为单位。
是否开启:“是”则前台交易区和后台各统计列表可见,“否”则不可见。
是否开启撮合:新添加的交易对需要开启撮合后,用户下单才能正常成交。如果某个币对下单出现异常,也可以通过切换开关,重启撮合来进行尝试。
选择撮合服务器地址:服务器地址在系统部署时会自动配置好,不需要手动编辑,当有多个服务器选项时,请提前跟运维人员确认应该选择哪个服务器。
参考开盘价:该币对历史第一笔成交之前,盘面显示的价格。
价格精度:交易区价格精确度,即计价货币的精度。此处需填写精确到的小数位数,如“4”(意为精确到0.0001)。
数量精度:交易区数量精确度,即基准货币的精度。此处需填写精确到的小数位数,如“4”(意为精确到0.0001)。
排序:该币对在前台页面“资金管理”模块中的排序,需填写阿拉伯数字。请注意,各币对排序按照设置数字从小到大顺次排列,若数字相同,则按照时间顺序排列。
深度0、1、2:在前台盘口的深度合并功能中显示的3个深度档位。请注意,深度0必须与“价格精度”保持一致。
交易区选择:可选择交易对的展示位置,展示的先后顺序为:主区>创新区>观察区,如下图所示
是否显示:如果币对设置为不显示,将从用户界面隐藏,但是用户可以通过搜索功能找到它。通常是未上线时用于预发布查看,或是便于持有已下架币种的用户进行卖出交易使用。
首页涨跌幅榜是否展示:设置隐藏的币对将不展示在首页涨幅榜列表里,但是可以在行情列表页和通过搜索功能找到它,如下图所示
数据库成交:新添加的交易对没有参考价格,如果依靠真实用户挂单成交获取初始价格,可能与真实价格偏离较大(其他交易所已上架的币对),因此可以指定一个用户账号以设定的价格进行一笔自成交,以此获取初始交易价格。如果该币对已经有成交(价格),则数据库成交功能无效。
目标价格:设定目标价格后,系统将在数据库创建一笔数量为限价交易最小量的成交。
下单UID:数据库成交的用户ID
是否属于ETF交易对:需要先通过KV:is_open_etf,把ETF开关打开,才会在币对配置中展示此配置。如果将交易对设置为ETF交易对,则该币对会出现在ETF交易区,而不是对应的计价货币区,如下图所示
是否开启网格交易:需要先通过KV:grid_trade_switch,把网格交易的开关打开,才会在币对配置中展示此配置。开启网格交易后,用户交易界面将显示网格交易功能,如下图所示
是否开启OpenAPI白名单:开启OpenAPI白名单后,只有白名单Token才能通过OpenAPI下单该币对
OpenAPI白名单:可以使用OpenAPI的Token,如有多个Token,用英文逗号“,”区隔
点击【确认】,现货交易区、场外交易区分别发布该币种信息到沙盒环境(并未真正生效)。此时“发布上线”按钮为红色状态。
确认本次修改的信息无误后,点击【发布上线】,按钮变为蓝色表示此次为修改已经生效(同步到前台系统)。
同币异链关系配置(多主链USDT充提合并)
功能背景:发行usdt的Tether公司在3个主链发行了这该币种,用户在充提时经常错乱,导致运营、开发人员需频繁处理这种因充错、提错的找回操作,人效低。
功能的目的:实现不同主链上的usdt系列币在同一个充提界面操作,且财务上统一记usdt一个币种的账。
A)基本概念
当前系统支持3个usdt币种,分别是:USDT(OMNI)、EUSDT(ERC20)、TUSDT(TRC20)(私有化客户可能不同主链命名有差别)
同币异链币种:某公司在不同主链上开发、发行的稳定币,且不同主链上该token的名称、价值一致,我们将这些token统称为同币异链币种。比如Tether公司在OMNI\ERC20\TRC20 3个不同主链上发行的USDT。
主币:在交易所中,每个币种都有唯一的名称,USDT下所有同币异链币种名称统一为USDT,所有币种的充提数据都统一到命名为USDT这个币种下。那么,我们将USDT(OMNI)作为USDT系列同币异链币种的“主币”。
从币:同一系列的同币异链币种中除了主币外的所有币种都是“从币”,例如:EUSDT(ERC20)、TUSDT(TRC20)。
注意:以下配置涉及资产关系变更,属极高级权限,系统上线默认超级管理员有权配置。
B)配置流程:
操作前置条件:首先确保您已经按照添加币种的方式添加了3个不同主链的USDT(OMNI、ERC20、TRC20),添加完成3个主链的USDT后继续下面的操作。
C)操作方式:
设置USDT(OMNI)为主币
1.1 打开USDT(OMNI)的币种管理编辑页面,点击页面右上角"同币异链币种设置"按钮,打开设置弹窗,如下:
1.2 设置值如下:
链名称:OMNI
币种类型:主币
下属从币:非配置项
开启充值、提现:依您需求配置
点击保存完成配置
完成以上操作,用户在充提界面操作时可以看到链名称OMNI(h5、app同理,下面不再截图展示)
2. 分别关联USDT(ERC20、TRC20)为从币
2.1 分别打开USDT(ERC20、TRC20)的币种管理编辑页面,点击页面右上角"同币异链币种设置"按钮,打开设置弹窗,如下:
2.2 设置值如下
链名称:ERC20、TRC20(币种为ERC20系列币则填写ERC20,TRC20同理)
币种类型:从币
主币名称:USDT
置换资产:先不操作
开启充值、提现:依您需求配置
点击保存完成配置
完成以上操作,用户在充提界面操作时可以看到链名称OMNI、ERC20、TRC20(h5、app同理,下面不再截图展示)
请完成至少一次从币的充提操作,确认充提不同主链的USDT将向同一个USDT账户记账。
3. 置换资产:将用户的ERC20、TRC20链的USDT资产置换为等量的USDT(OMNI)资产
3.1 确认上述主从关系配置无误后,点击现在执行,系统将会将用户的从币资产置换为主币资产(从币币币可用账户 转向 主币币币可用账户);
4. 配置主链提示文案
回到配置主币配置界面,打开链名称文案配置
我们为您提供了USDT多主链的文案参考(仅作为参考)
简体中文:请确保您选择的网络与您要充币/提币的网络一致,否则资产可能会丢失。
繁体中文:請確保您選擇的網絡與您要充幣/提幣的網絡一致,否則資產可能會丟失。
English:Ensure the network you choose matches the network you want to deposit/withdraw, or assets may be lost.
QA总结:
Q1:是否需要关闭从币的开启状态?
A1:不需要,主币、从币需要为开启状态,用户资产列表的从币信息将会处理为不显示。
Q2:为什么配置了前端没有生效?
A2:请确认您在后台发布了币种配置,稍等3分钟后,清除浏览器缓存后再打开网站即可生效。
交易手续费
手续费是交易所收入的主要来源之一。对各个币对手续费的设置在“手续费管理”下的“费率设置”菜单,由交易手续费、提现手续费、场外交易手续费三部分组成。
可对每个币对单独设置(配置币对详见 币对配置)。手续费的设置不分买卖方,但为了方便运营方接入做市商,给做市商打折,系统可支持挂单方(maker)和吃单方(taker)分别设置。在这里,挂单方指将当前币对的盘口此时没有的挂单提交的一方,吃单方指自行挂限价或市价单与当前盘口已有挂单成交的一方。填写0为免费,0.01为1%,0.003为3‰。
手续费折扣
系统支持为指定的用户设置某个时段的手续费分配折扣。
页面功能描述:
搜索:查询条件支持用户ID、手机号码、邮箱以及折扣范围区间查询。
新增:点击“添加”,会显示新增手续费折扣弹窗,在配置页面中可以通过用户的注册的手机号、邮箱设置折扣比例。
数据列表:默认查询所有设置的手续费折扣记录数据,按添加时间倒序排列。
编辑:点击“编辑”,会显示编辑手续费折扣弹窗,您可以重新设置配置参数。
功能介绍:
手机号/邮箱:输入需要设置手续费折扣用户的邮箱或手机号。
折扣率:折扣比例,折扣比例暂不支持大于 1 的比例。输入范围为:100% ~ 0% 。
有效时间:可以默认为长期有效,可以指定截止时间,设置完成后立即生效。
备注:支持备注功能。
手续费币种(平台币抵扣手续费)
为刺激平台币的流量和交易活跃度,系统支持将平台币设为手续费币种(适用于现货、杠杆交易)。
若关闭(选择未使用),则手续费扣减如常,按照交易币对的手续费率设置,扣除交易后双方新持有的币种;若开启,则用户在交易时,无论币种、币对,均按照实时汇率,优先扣除平台币;平台币不足时,先扣完平台币,剩余部分按照此开关未开启来处理,如下图。
字段说明:
是否开启平台币:
不开启:用户个人中心的“平台币作为手续费”设置这一行隐藏不显示,如下图;
开启:开启仅代表系统支持此功能,用户交易时想要进行抵扣,还需要在个人中心中开启自己的“平台币作为手续费”开关。开启后不能修改手续费币种,只可更改费率。
币种类型:选择平台已配置的任何一个币种作为手续费币种,需要确保该币种有过成交(最新成交价即为抵扣手续费时的兑换汇率),没有价格则无法进行抵扣;
平台币手续费率:支持使用该币种抵扣手续费的占比,填写0-1之间的数字,例如0.75表示可以使用配置的平台币支付75%的手续费,剩余25%按照原来的手续费币种支付;
提币手续费
提币手续费即为gas费,可按币种设置(配置币种详见 币种配置)。商户可以配置固定的提币手续费或通过“智能手续费”功能使用链上实时的gas费作为提币手续费,对应前台的位置见下图。
提币手续费后台配置功能说明,如下图:
列表字段说明:
币种:交易所币种列表中配置的名称;
提币手续费:对应用户在提币时需要支付的提币数量,精度不做限制。
使用“智能手续费”时,数据每分钟更新一次,逻辑如下:
当前币种是主链币:提币手续费 = 最新主链币提币手续费数量 * 提币手续费通用倍数;
当前币种是代币: 提币手续费 = 最新主链币提币手续费数量 * (主链币/代币的汇率) * 提币手续费通用倍数,如果获取不到主链币/代币的直接汇率,分别取 主链币/USDT 与 代币/USDT 的汇率,通过转换计算出 主链币/代币的汇率;
如果无法从接口获取或计算不出结果,则取“异常时提币手续费”;
不使用“智能手续费”时,按照商户配置的固定提币手续费收取;
如果显示0,则表示用户提币不需要支付gas费,提币费用由商户承担,需要及时处理;
是否智能调整:开启后取链上换算出来的提币手续费(或配置的异常提币手续费),关闭则取商户自行配置的手续费;
代币类型:取币种表中的“币种类型”字段,如果该币种是主链币,则主链币就是币种本身,比如BTC的主链币就是BTC,如果该币种是xx代币,则主链币是XX币,比如SHIB的主链币就是ETH;
最新主链币手续费:通过ChainUP Custody提供的接口,每分钟查询并更新一次主链币真实的gas费用(单位是主链币),精度取主链币的显示精度;
更新时间:最新主链币手续费更新成功的时间;
点击币种列表上方【智能手续费设置】按钮,可进行全局配置,如下图。
操作说明:
启用智能手续费:如果启用则所有币种同时开启,商户可以对单个币种进行关闭;如果关闭则所有币种同时关闭,商户不可以对单个币种进行开启,开启时有系统提示:请先启用智能手续费配置!
提币手续费倍数:可以设置1~100倍,精度保留小数点后两位,设置后,实际收取的提币手续费按照最新主链币(代币需按照汇率换算)的对应倍数收取(通常可以设置成2倍,用于弥补用户充值到交易所时,商户因资产归集产生的gas费成本)。修改倍数后,不会影响币种的“启用智能手续费“状态,原来未使用智能手续费的币种还是按照配置的固定数量收取提币手续费。
点击币种列表中的【修改】按钮,可以在弹窗内进行相关配置,如下图。
列表字段说明:
币种简称:展示对应币种,不可编辑;
启用智能手续费:对单个币种的开关
是:使用“智能手续费”功能,同时显示“异常时提币手续费”字段。该字段是应对获取不到代币和主链币之间的汇率,无法计算出实际提币数量的情况使用,系统会根据此处配置的数量向用户收取提币手续费,默认为0,即不向用户收取提币手续费;
否:不使用“智能手续费”功能,同时显示“提币手续费”字段,商户可自行设置固定的数量作为提币手续费,默认为空,即不收取手续费(列表展示0);
如果开启智能手续费(并获取了链上数据)后关闭,用户配置提币手续费时的默认值为上次更新的最新数量。
订单管理
如下图,订单管理的列表,按委托时间倒序显示平台所有订单。顶部提供按照交易 币对、按买卖方向、按成交状态、按挂单时间四类分类筛选功能,以及按用户 ID、按订单 ID 两种搜索功能,页面底部可以分页和翻页。
由于订单数据量较大,默认进入订单页面不会进行自动查询,所以页面会提示“未查询到相关数据”,您可以输入搜索条件,点击【查询】按钮进行查询。
功能介绍:
可以根据用户ID、订单编号、手机号邮箱、币对、订单状态、订单类型、委托时间进行精确查询。
订单类型:全部(买入&卖出)、买入、卖出。
订单状态
全部:全部状态的订单
初始订单:用户提交的委托订单,暂时未合并到盘口。
新订单:已经在盘口队列中,已经在撮合队列中的订单。
完全成交:全部成交的订单数据。
部分成交:只成交了部分的订单数据。
已撤单:已经撤销的用户订单。
待撤单:用户发起撤销申请,暂未从撮合队列中移除的订单。
异常订单:异常交易的订单,如:资金异常导致订单交易失败的订单。
币对:暂时只支持分币对查询订单记录。
操作功能
“展开”:已经成交的订单点击“展开”可以查询每笔成交的交易明细数据,如交易时间、交易数量、交易金额、交易手续费等。
“订单导出”:点击订单导出默认导出符合查询条件(支持根据搜索条件导出)的订单记录(订单数据)。
Last updated