在币圈各大社区论坛潜水，常常会听到老韭菜的肺腑之言。最近就听到了这样的一些言论：“炒泰达币比炒比特币获利高”“真没预料到今年竟然是USDT收益最好”。在经历“黑色星期四”数字货币价格暴跌之后，关于出入金的稳定币话题就没有停歇过。

 

稳定币指的是一种保持稳定价格的数字代币，一般情况下是由储备资产支持或者运用算法实现控制。常见的储备资产是能够采用加密货币或者法定货币。由于稳定币兼备区块链技术无法篡改的特征以及提供稳定价格的优势，这些稳定币深受玩币族的厚爱。

 

USDT泰达币作为入场最早也是当前最大的稳定币种，它不仅在市场早期占据了较大的份额，发展至今，一直稳居稳霸主地位，尽管后来不乏其他新稳定币种入场，但从资产总市值以及币种流通量来看，依旧另其他稳定币种望尘莫及。

 

就拿这次3.12事件来说，BTC暴跌直接导致币圈恐慌情绪瞬间蔓延，许多投资者急着将手中的BTC抛售换成了泰达币抵御风险，一些场外投资者则忙着进场抄底，在这两股资产力量的交相碰撞下，USDT泰达币溢价一度高达 14.29%，创市场历史新高。

 

虽然自新冠疫情全球爆发以来，USDT作为数字货币领域崩溃的经典避险资产，Tether公司不断在铸造USDT，用来实现投资者对加密货币的交易需求，但USDT仍在溢价。像ViaBTC 矿池 CEO杨海坡先生、自媒体币姥爷分别认为导致稳定币溢价的主要原因跟太多人抛售换 USDT以及此前市场大户出货相关联。毕竟人在恐慌情绪下，投资者都在寻求更安全、流动性最好的资产——美元，而稳定币就USDT与美元挂钩，其在数字货币市场中的地位基本上等同于美元。

 

区块链技术金融领域的不断创新和应用落地，大量的数字货币交易流水，催生了一批又一批的数字资产交易所。.数字货币行业在造就无数财富神话的同时，也伴随着许多交易所平台由于数字资产管理不当导致的资产被盗等事件。在头部和中小交易所发展探索中，安全是最为关键的一环，是交易所的生命线。交易所投资者一直在寻求安全存储和管理加密资产之道，由于技术瓶颈，或者时间、人力上的制约，他们往往在尝试自建团队开发区块链钱包对接交易所失败后，转而在互联网上寻找解决技术问题的方法。

 

根据权威媒体报道，多家一流加密货币交易所甚至头部交易所都遭遇过黑客非法入侵，导致平台资产被盗，就更别提一些规模较小的交易所了。所以如何安全地存储和管理交易所用户庞大的加密资产，应该是安全的同时也需要快速的业务对接，

 

今天就技术团队以及开发者最为关心的USDT钱包对接交易所问题，探索USDT充提币API接口如何对接。

 

首先，我们先了解充币和提币的关系，用个简单的例子来说明：小王从转USDT给交易所，USDT从小王钱包转入交易所账户对交易所系统来说就叫“充币”，反之，小王从交易所系统把USDT转出对于交易所系统来说就是“提币”。

 

USDT充提币API接口如何对接交易所呢？

原文链接：https://www.uduncloud.com/geteway-interface

 

1、目录

1.1、生成地址

1.2、提币

1.3、代付

1.4、交易回调

1.5、校验地址合法性

1.6、获取商户支持币种信息

2、接口明细

1、生成地址

1.1 场景说明

请求指定币种地址,如要成功获取地址,需先存在钱包,且钱包支持该币种

1.2 接口详情

1.2.1 接口地址

1.2.2 参数

1.2.2.1 参数说明

[

    {

     “merchantId”:”300015″,

     “coinType”:520,

     “callUrl”:”http://localhost:8080/callBack”

    }

]

1.2.2.2 body参数字段

1.2.2.3 示例

{

    “timestamp”: 1535005047,

    “nonce”: 10000,

    “sign”: “a230def43c1a12b14393880a28d4e005”,

    “body”: “[{\”merchantId\”:\”300015\”,\”coinType\”:520,\”callUrl\”:\”http://localhost:8080/callBack\”}]” 

}

1.2.3 返回状态码表

1.3 调取示例

1.3.1 成功

{

    “data”:{

        “coinType”:520,

        “address”:”0xbe4e3699cb870bc95365fe04a187dd279a651a58″

    },

    “message”:”SUCCESS”,

    “code”:200

}

1.3.2 失败

{

    “code”: “4101”,

    “message”: “SIGN_MSG_ERROR”

}

2、发送提币申请

2.1 场景说明

提币申请

2.2 接口详情

2.2.1 接口地址

2.2.2 参数

2.2.2.1 参数说明

[

    {

        “address”:”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s”,

        “amount”:”0.11″,

        “merchantId”:”100109″,

        “mainCoinType”:”144″,

        “coinType”:”144″,

        “callUrl”:”http://localhost:8080/mch/callBack”,

        “businessId”:”15″,

        “memo”:”10112″

    }

]

2.2.2.2 body参数字段

body参数名称	是否必填	类型	说明
address	是	String	提币地址
amount	是	String	提币数量
merchantId	是	String	商户号
mainCoinType	是	String	主币种编号 （见 附录一 ）
coinType	是	String	子币种编号 （见 附录一 ）
callUrl	是	String	回调地址，通过该callUrl告知您该笔提币交易的状态,具体示例见 交易回调接口
businessId	是	String	业务id，必须保证该字段在系统内唯一，如果重复，则该笔审核钱包不会接收。
memo	否	String	备注,XRP和EOS，这两种币的提币申请该字段可选，起他类型币种不填

2.2.2.3 示例

{

  “timestamp”: 1535005047,

  “nonce”: 100000,

  “sign”: “6df1512ee650431632ce1541a6b064e1”,

  “body”: “[{\”address\”:\”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s\”,\”amount\”:\”0.11\”,\”merchantId\”:\”100109\”,\”mainCoinType\”:\”144\”,\”coinType\”:\”144\”,\”callUrl\”:\”http://localhost:8080/callBack\”,\”businessId\”:\”15\”,\”memo\”:\”10112\”}]” 

}

2.2.3 返回状态码表

2.3.1 成功

{

    “message”:”SUCCESS”,

    “code”:200

}

2.3.2 失败

{

    “code”: “4101”,

    “message”: “SIGN_MSG_ERROR”

}

3、代付

3.1 场景说明

代付,发送自动付款申请，未设置代付信息或代付失败则进入审核状态。

3.2 接口详情

3.2.1 接口地址

3.2.2 参数

3.2.2.1 参数说明

[

  {

      “address”:”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s”,

      “amount”:”0.1″,

      “merchantId”:”100146″,

      “mainCoinType”:”144″,

      “coinType”:”144″,

      “callUrl”:”http://localhost:8080/callBack”,

      “businessId”:”571001″,

      “memo”:”10112″

  }

]

3.2.2.2 body参数说明

3.2.2.2 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “[{\”address\”:\”raadSxrUhG5EQVCY75CSGaVLWCeXd6yH6s\”,\”amount\”:\”0.1\”,\”merchantId\”:\”100146\”,\”mainCoinType\”:\”144\”,\”coinType\”:\”144\”,\”callUrl\”:\”http://localhost:8080/callBack\”,\”businessId\”:\”571001\”,\”memo\”:\”10112\”}]”

}

3.2.3 返回状态码表

3.3 调取示例

3.3.1 成功

{

    “message”:”SUCCESS”,

    “code”:200

}

3.3.2 失败

{

    “code”: “4101”,

    “message”: “SIGN_MSG_ERROR”

}

4、交易回调接口

4.1 场景说明

网关收到交易处理结果，调用商户提供的回调接口，通知商户具体变化信息。该接口网关发送给您指定的回调地址的内容，处理您的业务信息。 分充值回调和提币回调，其中提币最多会进行两次回调（审核回调+交易结果回调）

4.2 接口详情

4.2.1 接口地址

4.2.2 参数

4.2.2.1 参数说明

{

    “address”:”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW”,

    “amount”:”12345678″,

    “blockHigh”:”102419″,

    “coinType”:”206″,

    “decimals”:”8″,

    “fee”:”452000″,

    “mainCoinType”:”206″,

    “status”:3,

    “tradeId”:”20181024175416907″,

    “tradeType”:1,

    “txId”:”31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0″,

    “businessId”:””,// 提币回调为提币接口传入的businessId，充币无值

    “memo”:””

}

4.2.2.2 body参数说明

body参数名称	类型	说明
address	String	地址
amount	String	交易数量，根据币种精度获取实际金额，实际金额=amount/pow(10,decimals)，即实际金额等于amount除以10的decimals次方
fee	String	矿工费，根据币种精度获取实际金额，实际金额获取同上
decimals	String	币种精度
coinType	String	子币种编号,见 附录一
mainCoinType	String	主币种编号,见 附录一
businessId	String	业务编号，提币回调时为提币请求时传入的，充币回调无值
blockHigh	String	区块高度
status	Integer	状态，见 回调接口状态说明
tradeId	String	交易流水号
tradeType	Integer	交易类型,见 回调接口交易类型说明
txid	String	区块链交易哈希
memo	String	备注，XRP和EOS（见 附录一 ），这2种类型币的充提币可能有值

4.2.2.2 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “{\”address\”:\”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW\”,\”amount\”:\”12345678\”,\”blockHigh\”:\”102419\”,\”coinType\”:\”206\”,\”decimals\”:\”8\”,\”fee\”:\”452000\”,\”mainCoinType\”:\”206\”,\”status\”:3,\”tradeId\”:\”20181024175416907\”,\”tradeType\”:1,\”txId\”:\”31689c332536b56a2246347e206fbed2d04d461a3d668c4c1de32a75a8d436f0\”}”

}

5、校验地址合法性

5.1 场景说明

校验地址的合法性,添加地址、提币申请等场景时可先校验地址合法性，参看 校验规则

5.2 接口详情

5.2.1 接口地址

5.2.2 参数

5.2.2.1 参数说明

{

    “merchantId”:200000,

    “mainCoinType”:”206″,

    “address”:”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW”

}

5.2.2.2 body参数说明

5.2.2.2 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “[{\”merchantId\”:200000,\”mainCoinType\”:\”206\”,\”address\”:\”DJY781Z8qbuJeuA7C3McYivbX8kmAUXPsW\”}]”

5.2.3 返回状态码表

5.3 调取示例

5.3.1 成功

{

    “code”:200,

    “message”:”SUCCESS”

}

5.3.2 失败

{

    “code”:4005,

    “message”:”PARAM_ERROR”

}

6、获取商户支持的币种信息

6.1 场景说明

获取商户支持的币种,以及余额

6.2 接口详情

6.2.1 接口地址

6.2.2 参数

6.2.2.1 参数说明

6.2.2.2 body参数说明

body参数名称	类型	是否必填	说明
merchantId	Long	是	商户号
showBalance	Boolean	是	是否查询余额，false不获取，true获取

6.2.2.3 示例

{

    “timestamp”: 1535005047,

    “nonce”: 100000,

    “sign”: “e1bee3a417b9c606ba6cedda26db761a”,

    “body”: “{\”merchantId\”:\”200032\”,\”showBalance\”:true}”

}

6.2.3 返回状态码表

6.3 调取示例

6.3.1 成功

{

    “code”: 200,

    “message”: “SUCCESS”,

    “data”:[

        {

            “name”: “BTC”, // 币种别名

            “coinName”:”Bitcoin”, // 币种全称

            “symbol”:”BTC”, // 币种单位

            “mainCoinType”:”0″, //主币种类型

            “coinType”:”0″, // 币种类型

            “decimals”:”8″, // 币种精度

            “tokenStatus”:”0″, // 0： 主币 1：代币

            “mainSymbol”:”BTC”, //主币种单位

            “balance”:”0″, // 币种余额

            “logo”:”http://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/BTC.png” // 币种log地址

        },

        {

            “name”: “ETH”, // 币种别名

            “coinName”:”Ethereum”, // 币种全称

            “symbol”:”ETH”, // 币种单位

            “mainCoinType”:”60″, //主币种类型

            “coinType”:”60″, // 币种类型

            “decimals”:”18″, // 币种精度

            “tokenStatus”:”0″, // 0： 主币 1：代币

            “mainSymbol”:”ETH”, //主币种单位

            “balance”:”0″, // 币种余额

            “logo”:”https://bipay-admin.oss-cn-hangzhou.aliyuncs.com/bipay-admin-release/coin-logo/ETH.png” // 币种log地址

        }

    ]

}

6.3.2 失败

{

    “code”:4005,

    “message”:”BGS_ILLEGAL_PARAMETER”

}

附录一

回调接口状态说明

回调接口交易类型说明

验签说明

为了保证商户传送到优盾的参数信息不被恶意篡改，网关为商户接口提供Md5加密摘要认证。商户可用基础加密参数：时间戳、随机数、签名密钥(商户唯一的APIKEY)、请求明文参数按指定顺序排列进行Md5加密，产生一个验签串sign，商户请求网关接口时，带上参数时间戳、随机数、请求明文参数、sign作为参数。网关拿到相应的参数以同样的方式进行签名验签。同理，网关请求商户也以同样的方式进行身份验证。

sign=md5(body + key + nonce + timestamp)

key为接口授权码APIKEY，由网关分配给商户，加密字段顺序不能错误

币种地址校验规则

主币种类型	币种简称	币种英文名称	币种中文名称	地址前缀	地址长度限制区间
0	BTC	Bitcoin	比特币	1或者3	[26,36]
60	ETH	Ethereum	以太坊	0x	[42]
145	BCH	Bitcoincash	比特币现金	1	[26,36]
61	ETC	EthereumClassic	以太坊经典	0x	[42]
2	LTC	Litecoin	莱特币	L或者M	[26,36]
508	GX	GX		G	[26,36]
503	NBTC	NBTC		N	不限制
99	STO	STO	证券型通证发行	S	不限制
5	DASH	DASH	达世币	X	[26,36]
2301	QTUM	QTUM	量子链币	Q	[26,36]
133	ZEC	ZCash	大零币	t1	不限制
144	XRP	Ripple	瑞波币	r	[34]

以上仅展示了USDT充提币接口文档，完整地交易所对接USDT钱包接口还包括生成地址、代付、校验地址合法性、获取商户支持币种信息等多个信息内容，想了解更多USDT 钱包API接口干货，可持续关注博客园，本账户也会在博客园持续更新，同各位同学相互学习。