📗通则
CoinsDo的解决方案都是为满足用户需求而量身定制的,透过CoinsDo API用户可以直接体验到不同解决方案的众多功能以及让用户直接把功能接入到自己已有平台。
修订日期 : 2023-01-16
API URL
CoinsDo不仅为使用中的商户提供正式环境API,同时为开发、测试或学习目的的用户提供免费的测试环境
支持币种列表
正式链
1070
AB
0
AB
1071
AB
AB_ERC20
NEW182YefmbFPuCW14WtdXQYQo4YbM3TyB7QRex
1
FREE
51
ADA
0
ADA
195
ALGO
0
ALGO
783
AMB
AMB_ERC20
0x096b5914c95c34df19500daff77470c845ec749d
1
AirBond
209
ARB1
0
ETH
210
ARB1
ARB1_ERC20
0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9
1
USDT
276
ATOM
0
ATOM
53
AVAXC
0
AVAX
54
AVAXC
AVAXC_ERC20
0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7
1
USDt
732
BASE
0
ETH
733
BASE
0
USDC
9
BCH
0
BCH
807
BOR
BOR_BRC20
0x33acaa9a3168c10aeefc55dbeb659b7a7f242c7f
1
BOA
14
BSC
0
BNB
22
BSC
BEP20
0x1af3f329e8be154074d8769d1ffa4ee058b1dbc3
1
DAI
24
BSC
BEP20
0xf8a0bf9cf54bb92f17374d9e9a321e6a111a51bd
1
LINK
25
BSC
BEP20
0xcc42724c6683b7e57334c4e856f4c9965ed682bd
1
MATIC
26
BSC
BEP20
0x2859e4544c4bb03966803b044a93563bd2d0dd4d
1
SHIB
23
BSC
BEP20
0xbf5140a22578168fd562dccf235e5d43a02ce9b1
1
UNI
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
1087
ELY
0
ELY
1088
ELY
ELY_ERC20
0xc6e4564f2b74ef481d40329cd6c0f1c0e830a347
1
WN
11
EOS
0
EOS
7
ETC
0
ETC
2
ETH
0
ETH
15
ETH
ERC20
0xb8c77482e45f1f44de1745f52c74426c631bdd52
1
BNB
17
ETH
ERC20
0x6b175474e89094c44da98b954eedeac495271d0f
1
DAI
38
ETH
ERC20
0x6f259637dcd74c767781e37bc6133cd6a68aa161
1
HT
20
ETH
ERC20
0x514910771af9ca656af840dff83e8264ecf986ca
1
LINK
21
ETH
ERC20
0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0
1
MATIC
30
ETH
ERC20
0x75231f58b43240c9718dd58b4967c5114342a86c
1
OKB
16
ETH
ERC20
0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce
1
SHIB
19
ETH
ERC20
0x1f9840a85d5af5bf1d1762f925bdaddc4201f984
1
UNI
6
ETH
ERC20
0xdac17f958d2ee523a2206206994597c13d831ec7
1
USDT
18
ETH
ERC20
0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
1
WBTC
196
ETHW
0
ETHW
242
FIL
0
FIL
41
FTM
0
FTM
43
FTM
FTM_ERC20
0x321162cd933e2be498cd2267a90534a804051b11
1
BTC
44
FTM
FTM_ERC20
0x8d11ec38a3eb5e956b052f67da8bdc9bef8abf3e
1
DAI
42
FTM
FTM_ERC20
0xb3654dc3d10ea7645f8319668e8f54d2574fbdc8
1
LINK
27
HECO
0
HT
28
HECO
HRC20
0x9e004545c59d359f6b7bfb06a26390b087717b42
1
LINK
29
HECO
HRC20
0x22c54ce8321a4015740ee1109d9cbc25815c46e6
1
UNI
8
LTC
0
LTC
734
LUNC
0
LUNC
854
MATCH
MATCH_ERC20
0x39dbc91fa77d92c59376b424518904a9280cc72c
1
USDT
33
MATIC
0
MATIC
36
MATIC
MATIC_ERC20
0x8f3cf7ad23cd3cadbd9735aff958023239c6a063
1
DAI
34
MATIC
MATIC_ERC20
0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39
1
LINK
35
MATIC
MATIC_ERC20
0xb33eaad8d922b1083446dc23f610c2567fb5180f
1
UNI
37
MATIC
MATIC_ERC20
0x1bfd67037b42cf73acf2047067bd4f2c47d9bfd6
1
WBTC
131
MATIC
MATIC_ERC20
0x2791bca1f2de4661ed88a30c99a7a9449aa84174
1
USDC
747
MERL
0
MERL
748
MERL
MERL_ERC20
0x5c46bff4b38dc1eae09c5bac65872a1d8bc87378
1
MERL
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
735
SHIB
0
BONE
736
SHIB
1
WBONE
49
SOL
0
SOL
52
SOL
SPL
Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
1
USDT
947
SONIC
0
SONIC
948
SONIC
SONIC_ERC20
0x29219dd400f2bf60e5a23d13be72b486d4038894
1
USDC
781
TON
0
TON
817
TON
JETTON
EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs
1
USDT
3
TRX
0
TRX
39
TRX
TRC20
TDyvndWuvX5xTBwHPYJi7J3Yq8pq8yh62h
1
HT
5
TRX
TRC20
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
1
USDT
40
TRX
TRC20
TXpw8XeWYeTUd4quDskoUqeQPowRh4jY65
1
WBTC
883
WYZ
0
WYZ
884
WYZ
WRC20
0x804075813fc537f284233e88784469ea390c25f2
1
WYS
45
XDAI
0
XDAI
48
XDAI
XDAI_ERC20
0x44fa8e6f47987339850636f88629646662444217
1
DAI
46
XDAI
XDAI_ERC20
0xe2e73a1c69ecf83f464efce6a5be353a37ca09b2
1
LINK
47
XDAI
XDAI_ERC20
0x4537e328bf7e4efa29d05caea260d7fe26af9d74
1
UNI
243
XLM
0
XLM
50
XRP
0
XRP
649
XYM
0
XYM
12
ZEC
0
ZEC
测试链
707
AB
0
AB
709
AB
AB_ERC20
NEW17zRsawPpr1TV69YshZCY8cPsRJM5FuDy9qQ
1
Zombie
31
ADA
0
ADA
190
ALGO
0
ALGO
654
AMB
0
AMB
655
AMB
AMB_ERC20
0x096b5914c95c34df19500daff77470c845ec749d
1
AirBond
204
ARB1
0
ETH
205
ARB1
ARB1_ERC20
0x68fed128b095c919ee2c4f64e5c9b9eb64974a87
1
USDT
220
ATOM
0
ATOM
116
AVAXC
0
AVAX
117
AVAXC
AVAXC_ERC20
0xb5ad0e2d92560d0f588506a56e029e5fa1fc5570
1
WAVAX
644
BASE
0
ETH
645
BASE
0
USDC
9
BCH
0
BCH
677
BOR
BOR_BRC20
b33acaa9a3168c10aeefc55dbeb659b7a7f242c7f
1
BOA
14
BSC
0
BNB
15
BSC
BEP20
0xec5dcb5dbf4b114c9d0f65bccab49ec54f6a0867
1
DAI
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
713
ELY
0
ELY
714
ELY
ELY_ERC20
0xdee76baa1c4881f5780c02c5fdf6d42d1b3421e2
1
CDT
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
26
FTM
FTM_ERC20
0x378da755324ee4f1a5735a4f13499a410d82d122
1
CD
17
HECO
0
HT
18
HECO
HRC20
0x3e24e9d2c824b0ac2c82edc931b67252099b8e79
1
LINK
19
HECO
HRC20
0xd459dad367788893c17c09e17cfbf0bf25c62833
1
USDC
20
HECO
HRC20
0x04f535663110a392a6504839beed34e019fdb4e0
1
USDT
8
LTC
0
LTC
639
LUNC
0
LUNC
691
MATCH
0
BNB
692
MATCH
MATCH_ERC20
0x245fc0a7e2d1e629f5edf8543274ab2fe38359af
1
CDT
23
MATIC
0
MATIC
24
MATIC
MATIC_ERC20
0x326c977e6efc84e512bb9c30f76e30c160ed06fb
1
LINK
652
MERL
0
BTC
651
MERL
0
MERL
650
MERL
MERL
0x8ca2f5f38f37d377a320844c38064a0ef97b37e4
1
MERL
203
NEAR
0
NEAR
21
OKC
0
OKT
22
OKC
KIP20
0xda9d14072ef2262c64240da3a93fea2279253611
1
OKB
215
OP
0
ETH
216
OP
OPT_ERC20
0x6b84ad647c8bc943281d67e569f3572570d20d57
1
CD
219
OP
OPT_ERC20
0x94b008aa00579c1307b0ef2c499ad98a8ce58e58
1
USDT
29
SOL
0
SOL
100
SOL
SPL
4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
1
USDC
703
SONIC
0
SONIC
704
SONIC
SONIC_ERC20
0xaf93888cbd250300470a1618206e036e11470149
1
CORAL
660
TON
0
TON
679
TON
JETTON
EQC9GzFiNQ2Cygp2V2IDxQlFsbmtJbFXEbpc0QwyudyAfQZ
1
CDC
3
TRX
0
TRX
166
TRX
TRC20
TXLAQ63Xg1NAzckPwKHvzw7CSEmLMEqcdj
1
USDT
5
TRX
TRC20
TJwXPRrs39c9apaGsjccv7XiybkvYaLUhn
1
UT
699
WYZ
0
WYZ
700
WYZ
WRC20
0x32af4671788db409bbc87b7e7df038349b17f1e1
1
WYS
27
XDAI
0
XDAI
28
XDAI
XDAI_ERC20
0x3111c94b9243a8a99d5a867e00609900e437e2c0
1
FAU
214
XLM
0
XLM
30
XRP
0
XRP
617
XYM
0
XYM
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 //返回信息
}
获取当前矿工费
可通过此API查询某一币种的当前矿工费
接口描述
查询某一币种的当前矿工费
请求地址
{URL}/v1/txFeeGet
请求方式
POST
Body 参数
data
是
string
内容(JSON字符串,如下)
{
"apiKey": "aa465953d55641b3",
"coinsDoId": "25",
"timestamp": "2847982343622"
}
data 参数
apiKey
是
string
API KEY
coinsDoId
是
string
币种ID(参数见币种列表)
timestamp
是
string
时间戳(秒或毫秒)
请求示例
{
"data": "{\"apiKey\":\"aa465953d55641b3\",\"coinsDoId\":\"25\",\"timestamp\":\"2847982343622\"}",
"sign": "b7452bd73629ac1ddaae1096a1257a8a70262450b23c95f6c5f199d631d97486"
}
返回示例
{
"success": true,
"code": 200,
"msg": "Success",
"data": {
"transFee": "0.000021525084",
"updateTime": "1748329922"
}
}
transFee
是
string
币种的矿工费
updateTime
是
string
矿工费更新时间戳(秒)
获取各链当前高度
接口描述
查询各链当前高度
请求地址
{URL}/v1/blockNumberGet
请求方式
POST
请求示例
{
"data": "{\"apiKey\":\"aa465953d55641b3\",\"timestamp\":\"2847982343622\"}",
"sign": "7639a6a58d8ae74db48db3841f71a21b92e68131529c5e4d72ef4baa6234146b"
}
返回示例
{
"success": true,
"code": 200,
"msg": "Success",
"data": {
"blockNumberList": [
{
"currency": "ADA",
"latestNumber": "92652996",
"scanNumber": "3519718"
},
{
"currency": "ALGO",
"latestNumber": "51985959",
"scanNumber": "42260246"
},
{
"currency": "ARB1",
"latestNumber": "157274340",
"scanNumber": "55797388"
},
{
"currency": "ARB1_ERC20",
"latestNumber": "157274340",
"scanNumber": "55554107"
},
{
"currency": "ATOM",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "AVAXC",
"latestNumber": "40975753",
"scanNumber": "40975750"
},
{
"currency": "AVAXC_ERC20",
"latestNumber": "40975753",
"scanNumber": "40975751"
},
{
"currency": "BCH",
"latestNumber": "1659234",
"scanNumber": "1659233"
},
{
"currency": "BNB",
"latestNumber": "52676688",
"scanNumber": "52676277"
},
{
"currency": "BEP20",
"latestNumber": "52676688",
"scanNumber": "52599334"
},
{
"currency": "BSV",
"latestNumber": "1676446",
"scanNumber": "1557627"
},
{
"currency": "BTC",
"latestNumber": "4325100",
"scanNumber": "4325100"
},
{
"currency": "OMNI",
"latestNumber": "4408037",
"scanNumber": "4148045"
},
{
"currency": "DASH",
"latestNumber": "1258885",
"scanNumber": "1258885"
},
{
"currency": "DOGE",
"latestNumber": "8132183",
"scanNumber": "8132179"
},
{
"currency": "DOT",
"latestNumber": "26211647",
"scanNumber": "22790235"
},
{
"currency": "EOS",
"latestNumber": "204968789",
"scanNumber": null
},
{
"currency": "ETC",
"latestNumber": "13782067",
"scanNumber": "13782067"
},
{
"currency": "ETH",
"latestNumber": "8416520",
"scanNumber": "6800272"
},
{
"currency": "ERC20",
"latestNumber": "8416520",
"scanNumber": "6644598"
},
{
"currency": "ERC721",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "ERC1155",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "ETHW",
"latestNumber": "7168212",
"scanNumber": "17080074"
},
{
"currency": "FIL",
"latestNumber": "2700329",
"scanNumber": "1720412"
},
{
"currency": "FTM",
"latestNumber": "57627751",
"scanNumber": "26394756"
},
{
"currency": "FTM_ERC20",
"latestNumber": "57627751",
"scanNumber": "26394757"
},
{
"currency": "HT",
"latestNumber": null,
"scanNumber": "23643001"
},
{
"currency": "HRC20",
"latestNumber": null,
"scanNumber": "23643001"
},
{
"currency": "LTC",
"latestNumber": "3832131",
"scanNumber": "3832121"
},
{
"currency": "MATIC",
"latestNumber": "22176049",
"scanNumber": "15208453"
},
{
"currency": "MATIC_ERC20",
"latestNumber": "22176049",
"scanNumber": "15208453"
},
{
"currency": "NEAR",
"latestNumber": "198651320",
"scanNumber": "169904595"
},
{
"currency": "OKT",
"latestNumber": "34347084",
"scanNumber": "31785564"
},
{
"currency": "KIP20",
"latestNumber": "34347084",
"scanNumber": "31785564"
},
{
"currency": "OPT",
"latestNumber": "28266854",
"scanNumber": "16001277"
},
{
"currency": "OPT_ERC20",
"latestNumber": "28266854",
"scanNumber": "13934311"
},
{
"currency": "SOL",
"latestNumber": "383622952",
"scanNumber": "376613448"
},
{
"currency": "SPL",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "TRX",
"latestNumber": "57317699",
"scanNumber": "57317697"
},
{
"currency": "TRC20",
"latestNumber": "57317699",
"scanNumber": "57317695"
},
{
"currency": "XDAI",
"latestNumber": "40273331",
"scanNumber": "35159032"
},
{
"currency": "XDAI_ERC20",
"latestNumber": "40273331",
"scanNumber": "33240007"
},
{
"currency": "XLM",
"latestNumber": "1185079",
"scanNumber": "1708797"
},
{
"currency": "XRP",
"latestNumber": "7622039",
"scanNumber": "2433520"
},
{
"currency": "ZEC",
"latestNumber": "3415225",
"scanNumber": "3415223"
},
{
"currency": "XYM",
"latestNumber": "2407448",
"scanNumber": "1605773"
},
{
"currency": "XYM_TOKEN",
"latestNumber": "2407448",
"scanNumber": null
},
{
"currency": "BONE",
"latestNumber": "9052288",
"scanNumber": "9052287"
},
{
"currency": "BONE_ERC20",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "LUNC",
"latestNumber": "16864475",
"scanNumber": "16864474"
},
{
"currency": "BASE",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "BASE_ERC20",
"latestNumber": "26283981",
"scanNumber": "21000571"
},
{
"currency": "MERL",
"latestNumber": "18712372",
"scanNumber": "18089588"
},
{
"currency": "MERL_ERC20",
"latestNumber": "18712372",
"scanNumber": "14469866"
},
{
"currency": "AMB",
"latestNumber": "4585571",
"scanNumber": "4585571"
},
{
"currency": "AMB_ERC20",
"latestNumber": "4585571",
"scanNumber": "4585571"
},
{
"currency": "TON",
"latestNumber": "31582886",
"scanNumber": "31582884"
},
{
"currency": "JETTON",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "BOR",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "BOR_BRC20",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "MATCH",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "MATCH_ERC20",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "WYZ",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "WRC20",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "SONIC",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "SONIC_ERC20",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "AB",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "AB_ERC20",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "ELY",
"latestNumber": null,
"scanNumber": null
},
{
"currency": "ELY_ERC20",
"latestNumber": null,
"scanNumber": null
}
],
"timestamp": "2025-05-27T08:57:32.378+00:00"
}
}
data 参数
blockNumberList
是
array
区块高度列表
timestamp
是
string
时间戳(秒或毫秒)
blockNumberList 参数
currency
是
string
币种
latestNumber
否
string
当前链上最新高度
scanNumber
否
string
coinsdo扫块高度
返回状态码
4099
请求次数太频繁
商户查询账户下所有客户端在线状态API
接口描述
查询商户所有装置的在线状态
请求地址
{URL}/v1/onlineDeviceList
请求方式
POST
Body 参数
data
是
string
内容(JSON字符串,如下)
{
"apiKey": "7bb52d79e46e47ab",
"timestamp": "1744697998"
}
data 参数
apiKey
是
string
API KEY
timestamp
是
string
时间戳 (秒或毫秒)
请求示例
{
"data":"{\"apiKey\":\"7bb52d79e46e47ab\",\"timestamp\":\"1744697998\"}",
"sign":"03dabf4073bad9d5fcde3b881bba076cae211ac28b11995289740f96f51162a5"
}
返回示例
{
"success": true,
"code": 200,
"msg": "Success",
"data": [
{
"deviceUuid": "1ebec22c-d3b8-7940-0345-c3a8645252ad",
"deviceName": "Wong Yun Fat",
"deviceType": 0,
"onlineStatus": 1
},
{
"deviceUuid": "25604db6-2424-1ce7-1ddb-0e08c0946d1a",
"deviceName": "Fung Wing Sze",
"deviceType": 1,
"onlineStatus": 0
},
{
"deviceUuid": "27298be4-9ee4-0289-8819-b4b9f06376d6",
"deviceName": "Nakagawa Airi",
"deviceType": 1,
"onlineStatus": 1
},
{
"deviceUuid": "5c72cbde-7357-c2e6-0710-ce0605e16a6f",
"deviceName": "Rose Gonzalez",
"deviceType": 0,
"onlineStatus": 0
}
]
}
data 参数
deviceName
是
string
设备名称
deviceUuid
是
string
设备UUID
deviceType
是
Integer
设备类型(0.下发 1.归集)
onlineStatus
是
Integer
在线状态(0.离线 1.在线)
返回状态码
4002
参数格式错误
4003
JSON数据转换异常
4004
APIKEY不存在
4005
ip受限,当前ip:
4007
验签失败
4010
请求过期
4068
检查APIKEY失败
4099
请求次数太频繁
4143
查询在线设备失败
4144
查询归集在线设备失败
4145
查询商户设备失败
最后更新于
这有帮助吗?