📗通则

CoinsDo的解决方案都是为满足用户需求而量身定制的，透过CoinsDo API用户可以直接体验到不同解决方案的众多功能以及让用户直接把功能接入到自己已有平台。

• 修订日期 : 2023-01-16

API URL

CoinsDo不仅为使用中的商户提供正式环境API，同时为开发、测试或学习目的的用户提供免费的测试环境

网络环境	URL
正式	https://open.coinsdo.com/coinsdo/open
测试	https://open.coinsdotest.com/coinsdo/open

支持币种列表

请前往您的CoinSend/CoinGet中心的货币控制列表，以获取最新的coinsDoId。

正式链

coinsDoId	mainnet	protocol	tokenAddress	coinType (0-coin; 1-token)	coinName
51	ADA			0
195	ALGO			0
209	ARB1			0
210	ARB1	ARB1_ERC20	0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9	1	USDT
276	ATOM			0	ATOM
53	AVAXC			0	AVAX
54	AVAXC	AVAXC_ERC20	0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7	1	USDt
9	BCH			0	BCH
14	BSC			0	BNB
70	BSC	BEP20	0xe9e7cea3dedca5984780bafc599bd69add087d56	1	BUSD
76	BSC	BEP20	0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d	1	USDC
58	BSC	BEP20	0x55d398326f99059ff775485246999027b3197955	1	USDT
278	BSV			0	BSV
1	BTC			0	BTC
4	BTC	OMNI	31	1	USDT
13	DASH			0	DASH
10	DOGE			0	DOGE
119	DOT			0	DOT
11	EOS			0	EOS
7	ETC			0	ETC
2	ETH			0	ETH
6	ETH	ERC20	0xdac17f958d2ee523a2206206994597c13d831ec7	1	USDT
18	ETH	ERC20	0x2260fac5e5542a773aa44fbcfedf7c193bc2c599	1	WBTC
196	ETHW			0	ETHW
242	FIL			0	FIL
41	FTM			0	FTM
27	HECO			0	HT
8	LTC			0	LTC
33	MATIC			0	MATIC
131	MATIC	MATIC_ERC20	0x2791bca1f2de4661ed88a30c99a7a9449aa84174	1	USDC
208	NEAR			0	NEAR
31	OKC			0	OKT
32	OKC	KIP20	0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2	1	OKB
272	OP			0	ETH
273	OP	OPT_ERC20	0x94b008aa00579c1307b0ef2c499ad98a8ce58e58	1	USDT
49	SOL			0	SOL
52	SOL	SPL	Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB	1	USDT
3	TRX			0	TRX
5	TRX	TRC20	TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t	1	USDT
45	XDAI			0	XDAI
243	XLM			0	XLM
50	XRP			0	XRP
12	ZEC			0	ZEC

测试链

coinsDoId	mainnet	protocol	tokenAddress	coinType (0-coin; 1-token)	coinName
31	ADA			0	ADA
190	ALGO			0	ALGO
204	ARB1			0	ETH
205	ARB1	ARB1_ERC20	0x68fed128b095c919ee2c4f64e5c9b9eb64974a87	1	USDT
220	ATOM			0	ATOM
116	AVAXC			0	AVAX
9	BCH			0	BCH
14	BSC			0	BNB
16	BSC	BEP20	0x337610d27c682e347c9cd60bd4b3b107c9d34ddd	1	USDT
221	BSV			0	BSV
1	BTC			0	BTC
4	BTC	OMNI	2	1	USDT
13	DASH			0	DASH
10	DOGE			0	DOGE
163	DOT			0	DOT
11	EOS			0	EOS
7	ETC			0	ETC
2	ETH			0	ETH
6	ETH	ERC20	0x378da755324ee4f1a5735a4f13499a410d82d122	1	USDT
191	ETHW			0	ETHW
213	FIL			0	FIL
25	FTM			0	FTM
17	HECO			0	HT
19	HECO	HRC20	0xd459dad367788893c17c09e17cfbf0bf25c62833	1	USDC
20	HECO	HRC20	0x04f535663110a392a6504839beed34e019fdb4e0	1	USDT
8	LTC			0	LTC
23	MATIC			0	MATIC
203	NEAR			0	NEAR
21	OKC			0	OKT
22	OKC	KIP20	0xda9d14072ef2262c64240da3a93fea2279253611	1	OKB
215	OP			0	ETH
219	OP	OPT_ERC20	0x94b008aa00579c1307b0ef2c499ad98a8ce58e58	1	USDT
29	SOL			0	SOL
100	SOL	SPL	4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU	1	USDC
3	TRX			0	TRX
5	TRX	TRC20	TJwXPRrs39c9apaGsjccv7XiybkvYaLUhn	1	UT
27	XDAI			0	XDAI
214	XLM			0	XLM
30	XRP			0	XRP
12	ZEC			0	ZEC

请求API

快速了解如何请求 CoinsDo API。

请求方式

• POST

请求参数

• Header 参数

参数名	必填	类型/参数值
Content-Type	是	application/json

• Body 参数

参数名	必填	类型	说明
sign	是	string	签名
data	是	string	内容（JSON字符串,具体看每个接口详情定义）

• 签名规则

签名使用HMAC-SHA256算法。

API-KEY所对应的Secret-KEY作为HMAC-SHA256的密钥，对data参数进行加密，得到的输出即为签名。

例如，密钥1024对data参数的签名：

    {
        "data": "{\"apiKey\":\"cd384rt80f5575dc\",\"mainnet\":\"TRX\",\"targetDeviceUuid\":\"085C28EC-0BD6-442B-8232-D23BC8F4D58E\",\"timestamp\":\"1622775712229\",\"addressRemark\":\"trx address\"}",
        "sign": "852cd95d5045f3e41db0447cdde405b73cc03b8844b76da74bd0b498470cba75"
    } 

响应参数

 {
    "code": 200, // 状态码
    "msg": "成功", // 提示信息
    "data": null // 返回内容
}

状态码

状态码	说明
-2	系统异常
200	成功
4001	接口未找到
4002	参数格式错误
4003	JSON数据转换异常
4004	APIKEY不存在
4005	ip受限
4007	验签失败
4010	请求过期
4068	检查APIKEY失败

*每个接口有各自的状态码

回调通知

通过回调通知API将下发记录审批结果、归集收币到账确认状态通知至商户后台设置的回调URL。

回调场景

• 当你选择处理时，响应code为200视为回调成功，不再回调

• 当你选择忽略时，响应code为202视为忽略成功，不再回调（可选项，实际效果等同于200，作用仅限于标识是否处理）

回调场景	描述	建议
下发	下发请求链上交易(成功/驳回/取消）	处理
归集收币一个确认	存币后链上达到一个确认数(中间状态)	处理/忽略
归集收币到账	达到指定确认数&核查成功(最终状态)入账	处理

请求方式

• POST

请求参数

• Header 参数

参数名	必填	类型/参数值
Content-Type	是	application/json

• Body 参数

参数名	必填	类型	说明
sign	是	string	签名
data	是	string	内容（JSON字符串）

返回示例

{
    "code": 200, // 状态码
    "msg": "成功", // 提示信息
    "data": null //返回信息 
}