# 通则

* 修订日期 : 2023-01-16

## API URL <a href="#api-url" id="api-url"></a>

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

<table><thead><tr><th width="139">网络环境</th><th>URL</th></tr></thead><tbody><tr><td>正式</td><td><a href="https://open.coinsdo.com/coinsdo/open">https://open.coinsdo.com/coinsdo/open</a></td></tr><tr><td>测试</td><td><a href="https://open.coinsdotest.com/coinsdo/open">https://open.coinsdotest.com/coinsdo/open</a></td></tr></tbody></table>

## 支持币种列表 <a href="#undefined" id="undefined"></a>

{% hint style="info" %}
请前往您的CoinSend/CoinGet中心的货币控制列表，以获取最新的CoinsDo ID。

![](https://254105150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx1sJpsLJyJ12eTG1bUgP%2Fuploads%2FfbFGWiBFdFxnbjzdddCl%2Fimage.png?alt=media\&token=b464433f-48d7-447b-9642-67bb89cc7c00)
{% endhint %}

### 正式链

<table><thead><tr><th width="93.61328125">coinsDoId</th><th width="86.76171875">mainnet</th><th width="144.33203125">protocol</th><th width="258">tokenAddress</th><th width="93.16796875">coinType (0-coin; 1-token)</th><th>coinName</th></tr></thead><tbody><tr><td>1070</td><td>AB</td><td></td><td></td><td>0</td><td>AB</td></tr><tr><td>1071</td><td>AB</td><td>AB_ERC20</td><td>NEW182YefmbFPuCW14WtdXQYQo4YbM3TyB7QRex</td><td>1</td><td>FREE</td></tr><tr><td>51</td><td>ADA</td><td></td><td></td><td>0</td><td>ADA</td></tr><tr><td>195</td><td>ALGO</td><td></td><td></td><td>0</td><td>ALGO</td></tr><tr><td>783</td><td>AMB</td><td>AMB_ERC20</td><td>0x096b5914c95c34df19500daff77470c845ec749d</td><td>1</td><td>AirBond</td></tr><tr><td>209</td><td>ARB1</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>210</td><td>ARB1</td><td>ARB1_ERC20</td><td>0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9</td><td>1</td><td>USDT</td></tr><tr><td>276</td><td>ATOM</td><td></td><td></td><td>0</td><td>ATOM</td></tr><tr><td>53</td><td>AVAXC</td><td></td><td></td><td>0</td><td>AVAX</td></tr><tr><td>54</td><td>AVAXC</td><td>AVAXC_ERC20</td><td>0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7</td><td>1</td><td>USDt</td></tr><tr><td>732</td><td>BASE</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>733</td><td>BASE</td><td></td><td></td><td>0</td><td>USDC</td></tr><tr><td>9</td><td>BCH</td><td></td><td></td><td>0</td><td>BCH</td></tr><tr><td>807</td><td>BOR</td><td>BOR_BRC20</td><td>0x33acaa9a3168c10aeefc55dbeb659b7a7f242c7f</td><td>1</td><td>BOA</td></tr><tr><td>14</td><td>BSC</td><td></td><td></td><td>0</td><td>BNB</td></tr><tr><td>22</td><td>BSC</td><td>BEP20</td><td>0x1af3f329e8be154074d8769d1ffa4ee058b1dbc3</td><td>1</td><td>DAI</td></tr><tr><td>24</td><td>BSC</td><td>BEP20</td><td>0xf8a0bf9cf54bb92f17374d9e9a321e6a111a51bd</td><td>1</td><td>LINK</td></tr><tr><td>25</td><td>BSC</td><td>BEP20</td><td>0xcc42724c6683b7e57334c4e856f4c9965ed682bd</td><td>1</td><td>MATIC</td></tr><tr><td>26</td><td>BSC</td><td>BEP20</td><td>0x2859e4544c4bb03966803b044a93563bd2d0dd4d</td><td>1</td><td>SHIB</td></tr><tr><td>23</td><td>BSC</td><td>BEP20</td><td>0xbf5140a22578168fd562dccf235e5d43a02ce9b1</td><td>1</td><td>UNI</td></tr><tr><td>70</td><td>BSC</td><td>BEP20</td><td>0xe9e7cea3dedca5984780bafc599bd69add087d56</td><td>1</td><td>BUSD</td></tr><tr><td>76</td><td>BSC</td><td>BEP20</td><td>0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d</td><td>1</td><td>USDC</td></tr><tr><td>58</td><td>BSC</td><td>BEP20</td><td>0x55d398326f99059ff775485246999027b3197955</td><td>1</td><td>USDT</td></tr><tr><td>278</td><td>BSV</td><td></td><td></td><td>0</td><td>BSV</td></tr><tr><td>1</td><td>BTC</td><td></td><td></td><td>0</td><td>BTC</td></tr><tr><td>4</td><td>BTC</td><td>OMNI</td><td>31</td><td>1</td><td>USDT</td></tr><tr><td>13</td><td>DASH</td><td></td><td></td><td>0</td><td>DASH</td></tr><tr><td>10</td><td>DOGE</td><td></td><td></td><td>0</td><td>DOGE</td></tr><tr><td>119</td><td>DOT</td><td></td><td></td><td>0</td><td>DOT</td></tr><tr><td>1087</td><td>ELY</td><td></td><td></td><td>0</td><td>ELY</td></tr><tr><td>1088</td><td>ELY</td><td>ELY_ERC20</td><td>0xc6e4564f2b74ef481d40329cd6c0f1c0e830a347</td><td>1</td><td>WN</td></tr><tr><td>11</td><td>EOS</td><td></td><td></td><td>0</td><td>EOS</td></tr><tr><td>7</td><td>ETC</td><td></td><td></td><td>0</td><td>ETC</td></tr><tr><td>2</td><td>ETH</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>15</td><td>ETH</td><td>ERC20</td><td>0xb8c77482e45f1f44de1745f52c74426c631bdd52</td><td>1</td><td>BNB</td></tr><tr><td>17</td><td>ETH</td><td>ERC20</td><td>0x6b175474e89094c44da98b954eedeac495271d0f</td><td>1</td><td>DAI</td></tr><tr><td>38</td><td>ETH</td><td>ERC20</td><td>0x6f259637dcd74c767781e37bc6133cd6a68aa161</td><td>1</td><td>HT</td></tr><tr><td>20</td><td>ETH</td><td>ERC20</td><td>0x514910771af9ca656af840dff83e8264ecf986ca</td><td>1</td><td>LINK</td></tr><tr><td>21</td><td>ETH</td><td>ERC20</td><td>0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0</td><td>1</td><td>MATIC</td></tr><tr><td>30</td><td>ETH</td><td>ERC20</td><td>0x75231f58b43240c9718dd58b4967c5114342a86c</td><td>1</td><td>OKB</td></tr><tr><td>16</td><td>ETH</td><td>ERC20</td><td>0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce</td><td>1</td><td>SHIB</td></tr><tr><td>19</td><td>ETH</td><td>ERC20</td><td>0x1f9840a85d5af5bf1d1762f925bdaddc4201f984</td><td>1</td><td>UNI</td></tr><tr><td>6</td><td>ETH</td><td>ERC20</td><td>0xdac17f958d2ee523a2206206994597c13d831ec7</td><td>1</td><td>USDT</td></tr><tr><td>18</td><td>ETH</td><td>ERC20</td><td>0x2260fac5e5542a773aa44fbcfedf7c193bc2c599</td><td>1</td><td>WBTC</td></tr><tr><td>196</td><td>ETHW</td><td></td><td></td><td>0</td><td>ETHW</td></tr><tr><td>242</td><td>FIL</td><td></td><td></td><td>0</td><td>FIL</td></tr><tr><td>41</td><td>FTM</td><td></td><td></td><td>0</td><td>FTM</td></tr><tr><td>43</td><td>FTM</td><td>FTM_ERC20</td><td>0x321162cd933e2be498cd2267a90534a804051b11</td><td>1</td><td>BTC</td></tr><tr><td>44</td><td>FTM</td><td>FTM_ERC20</td><td>0x8d11ec38a3eb5e956b052f67da8bdc9bef8abf3e</td><td>1</td><td>DAI</td></tr><tr><td>42</td><td>FTM</td><td>FTM_ERC20</td><td>0xb3654dc3d10ea7645f8319668e8f54d2574fbdc8</td><td>1</td><td>LINK</td></tr><tr><td>27</td><td>HECO</td><td></td><td></td><td>0</td><td>HT</td></tr><tr><td>28</td><td>HECO</td><td>HRC20</td><td>0x9e004545c59d359f6b7bfb06a26390b087717b42</td><td>1</td><td>LINK</td></tr><tr><td>29</td><td>HECO</td><td>HRC20</td><td>0x22c54ce8321a4015740ee1109d9cbc25815c46e6</td><td>1</td><td>UNI</td></tr><tr><td>8</td><td>LTC</td><td></td><td></td><td>0</td><td>LTC</td></tr><tr><td>734</td><td>LUNC</td><td></td><td></td><td>0</td><td>LUNC</td></tr><tr><td>854</td><td>MATCH</td><td>MATCH_ERC20</td><td>0x39dbc91fa77d92c59376b424518904a9280cc72c</td><td>1</td><td>USDT</td></tr><tr><td>33</td><td>MATIC</td><td></td><td></td><td>0</td><td>MATIC</td></tr><tr><td>36</td><td>MATIC</td><td>MATIC_ERC20</td><td>0x8f3cf7ad23cd3cadbd9735aff958023239c6a063</td><td>1</td><td>DAI</td></tr><tr><td>34</td><td>MATIC</td><td>MATIC_ERC20</td><td>0x53e0bca35ec356bd5dddfebbd1fc0fd03fabad39</td><td>1</td><td>LINK</td></tr><tr><td>35</td><td>MATIC</td><td>MATIC_ERC20</td><td>0xb33eaad8d922b1083446dc23f610c2567fb5180f</td><td>1</td><td>UNI</td></tr><tr><td>37</td><td>MATIC</td><td>MATIC_ERC20</td><td>0x1bfd67037b42cf73acf2047067bd4f2c47d9bfd6</td><td>1</td><td>WBTC</td></tr><tr><td>131</td><td>MATIC</td><td>MATIC_ERC20</td><td>0x2791bca1f2de4661ed88a30c99a7a9449aa84174</td><td>1</td><td>USDC</td></tr><tr><td>747</td><td>MERL</td><td></td><td></td><td>0</td><td>MERL</td></tr><tr><td>748</td><td>MERL</td><td>MERL_ERC20</td><td>0x5c46bff4b38dc1eae09c5bac65872a1d8bc87378</td><td>1</td><td>MERL</td></tr><tr><td>208</td><td>NEAR</td><td></td><td></td><td>0</td><td>NEAR</td></tr><tr><td>31</td><td>OKC</td><td></td><td></td><td>0</td><td>OKT</td></tr><tr><td>32</td><td>OKC</td><td>KIP20</td><td>0xdf54b6c6195ea4d948d03bfd818d365cf175cfc2</td><td>1</td><td>OKB</td></tr><tr><td>272</td><td>OP</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>273</td><td>OP</td><td>OPT_ERC20</td><td>0x94b008aa00579c1307b0ef2c499ad98a8ce58e58</td><td>1</td><td>USDT</td></tr><tr><td>735</td><td>SHIB</td><td></td><td></td><td>0</td><td>BONE</td></tr><tr><td>736</td><td>SHIB</td><td></td><td></td><td>1</td><td>WBONE</td></tr><tr><td>49</td><td>SOL</td><td></td><td></td><td>0</td><td>SOL</td></tr><tr><td>52</td><td>SOL</td><td>SPL</td><td>Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB</td><td>1</td><td>USDT</td></tr><tr><td>947</td><td>SONIC</td><td></td><td></td><td>0</td><td>SONIC</td></tr><tr><td>948</td><td>SONIC</td><td>SONIC_ERC20</td><td>0x29219dd400f2bf60e5a23d13be72b486d4038894</td><td>1</td><td>USDC</td></tr><tr><td>781</td><td>TON</td><td></td><td></td><td>0</td><td>TON</td></tr><tr><td>817</td><td>TON</td><td>JETTON</td><td>EQCxE6mUtQJKFnGfaROTKOt1lZbDiiX1kCixRv7Nw2Id_sDs</td><td>1</td><td>USDT</td></tr><tr><td>3</td><td>TRX</td><td></td><td></td><td>0</td><td>TRX</td></tr><tr><td>39</td><td>TRX</td><td>TRC20</td><td>TDyvndWuvX5xTBwHPYJi7J3Yq8pq8yh62h</td><td>1</td><td>HT</td></tr><tr><td>5</td><td>TRX</td><td>TRC20</td><td>TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t</td><td>1</td><td>USDT</td></tr><tr><td>40</td><td>TRX</td><td>TRC20</td><td>TXpw8XeWYeTUd4quDskoUqeQPowRh4jY65</td><td>1</td><td>WBTC</td></tr><tr><td>883</td><td>WYZ</td><td></td><td></td><td>0</td><td>WYZ</td></tr><tr><td>884</td><td>WYZ</td><td>WRC20</td><td>0x804075813fc537f284233e88784469ea390c25f2</td><td>1</td><td>WYS</td></tr><tr><td>45</td><td>XDAI</td><td></td><td></td><td>0</td><td>XDAI</td></tr><tr><td>48</td><td>XDAI</td><td>XDAI_ERC20</td><td>0x44fa8e6f47987339850636f88629646662444217</td><td>1</td><td>DAI</td></tr><tr><td>46</td><td>XDAI</td><td>XDAI_ERC20</td><td>0xe2e73a1c69ecf83f464efce6a5be353a37ca09b2</td><td>1</td><td>LINK</td></tr><tr><td>47</td><td>XDAI</td><td>XDAI_ERC20</td><td>0x4537e328bf7e4efa29d05caea260d7fe26af9d74</td><td>1</td><td>UNI</td></tr><tr><td>243</td><td>XLM</td><td></td><td></td><td>0</td><td>XLM</td></tr><tr><td>50</td><td>XRP</td><td></td><td></td><td>0</td><td>XRP</td></tr><tr><td>649</td><td>XYM</td><td></td><td></td><td>0</td><td>XYM</td></tr><tr><td>12</td><td>ZEC</td><td></td><td></td><td>0</td><td>ZEC</td></tr></tbody></table>

### 测试链

<table><thead><tr><th width="94.33984375">coinsDoId</th><th width="83.26171875">mainnet</th><th width="139.98828125">protocol</th><th width="264">tokenAddress</th><th width="91.6875">coinType (0-coin; 1-token)</th><th>coinName</th></tr></thead><tbody><tr><td>707</td><td>AB</td><td></td><td></td><td>0</td><td>AB</td></tr><tr><td>709</td><td>AB</td><td>AB_ERC20</td><td>NEW17zRsawPpr1TV69YshZCY8cPsRJM5FuDy9qQ</td><td>1</td><td>Zombie</td></tr><tr><td>31</td><td>ADA</td><td></td><td></td><td>0</td><td>ADA</td></tr><tr><td>190</td><td>ALGO</td><td></td><td></td><td>0</td><td>ALGO</td></tr><tr><td>654</td><td>AMB</td><td></td><td></td><td>0</td><td>AMB</td></tr><tr><td>655</td><td>AMB</td><td>AMB_ERC20</td><td>0x096b5914c95c34df19500daff77470c845ec749d</td><td>1</td><td>AirBond</td></tr><tr><td>204</td><td>ARB1</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>205</td><td>ARB1</td><td>ARB1_ERC20</td><td>0x68fed128b095c919ee2c4f64e5c9b9eb64974a87</td><td>1</td><td>USDT</td></tr><tr><td>220</td><td>ATOM</td><td></td><td></td><td>0</td><td>ATOM</td></tr><tr><td>116</td><td>AVAXC</td><td></td><td></td><td>0</td><td>AVAX</td></tr><tr><td>117</td><td>AVAXC</td><td>AVAXC_ERC20</td><td>0xb5ad0e2d92560d0f588506a56e029e5fa1fc5570</td><td>1</td><td>WAVAX</td></tr><tr><td>644</td><td>BASE</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>645</td><td>BASE</td><td></td><td></td><td>0</td><td>USDC</td></tr><tr><td>9</td><td>BCH</td><td></td><td></td><td>0</td><td>BCH</td></tr><tr><td>677</td><td>BOR</td><td>BOR_BRC20</td><td>b33acaa9a3168c10aeefc55dbeb659b7a7f242c7f</td><td>1</td><td>BOA</td></tr><tr><td>14</td><td>BSC</td><td></td><td></td><td>0</td><td>BNB</td></tr><tr><td>15</td><td>BSC</td><td>BEP20</td><td>0xec5dcb5dbf4b114c9d0f65bccab49ec54f6a0867</td><td>1</td><td>DAI</td></tr><tr><td>16</td><td>BSC</td><td>BEP20</td><td>0x337610d27c682e347c9cd60bd4b3b107c9d34ddd</td><td>1</td><td>USDT</td></tr><tr><td>221</td><td>BSV</td><td></td><td></td><td>0</td><td>BSV</td></tr><tr><td>1</td><td>BTC</td><td></td><td></td><td>0</td><td>BTC</td></tr><tr><td>4</td><td>BTC</td><td>OMNI</td><td>2</td><td>1</td><td>USDT</td></tr><tr><td>13</td><td>DASH</td><td></td><td></td><td>0</td><td>DASH</td></tr><tr><td>10</td><td>DOGE</td><td></td><td></td><td>0</td><td>DOGE</td></tr><tr><td>163</td><td>DOT</td><td></td><td></td><td>0</td><td>DOT</td></tr><tr><td>713</td><td>ELY</td><td></td><td></td><td>0</td><td>ELY</td></tr><tr><td>714</td><td>ELY</td><td>ELY_ERC20</td><td>0xdee76baa1c4881f5780c02c5fdf6d42d1b3421e2</td><td>1</td><td>CDT</td></tr><tr><td>11</td><td>EOS</td><td></td><td></td><td>0</td><td>EOS</td></tr><tr><td>7</td><td>ETC</td><td></td><td></td><td>0</td><td>ETC</td></tr><tr><td>2</td><td>ETH</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>6</td><td>ETH</td><td>ERC20</td><td>0x378da755324ee4f1a5735a4f13499a410d82d122</td><td>1</td><td>USDT</td></tr><tr><td>191</td><td>ETHW</td><td></td><td></td><td>0</td><td>ETHW</td></tr><tr><td>213</td><td>FIL</td><td></td><td></td><td>0</td><td>FIL</td></tr><tr><td>25</td><td>FTM</td><td></td><td></td><td>0</td><td>FTM</td></tr><tr><td>26</td><td>FTM</td><td>FTM_ERC20</td><td>0x378da755324ee4f1a5735a4f13499a410d82d122</td><td>1</td><td>CD</td></tr><tr><td>17</td><td>HECO</td><td></td><td></td><td>0</td><td>HT</td></tr><tr><td>18</td><td>HECO</td><td>HRC20</td><td>0x3e24e9d2c824b0ac2c82edc931b67252099b8e79</td><td>1</td><td>LINK</td></tr><tr><td>19</td><td>HECO</td><td>HRC20</td><td>0xd459dad367788893c17c09e17cfbf0bf25c62833</td><td>1</td><td>USDC</td></tr><tr><td>20</td><td>HECO</td><td>HRC20</td><td>0x04f535663110a392a6504839beed34e019fdb4e0</td><td>1</td><td>USDT</td></tr><tr><td>8</td><td>LTC</td><td></td><td></td><td>0</td><td>LTC</td></tr><tr><td>639</td><td>LUNC</td><td></td><td></td><td>0</td><td>LUNC</td></tr><tr><td>691</td><td>MATCH</td><td></td><td></td><td>0</td><td>BNB</td></tr><tr><td>692</td><td>MATCH</td><td>MATCH_ERC20</td><td>0x245fc0a7e2d1e629f5edf8543274ab2fe38359af</td><td>1</td><td>CDT</td></tr><tr><td>23</td><td>MATIC</td><td></td><td></td><td>0</td><td>MATIC</td></tr><tr><td>24</td><td>MATIC</td><td>MATIC_ERC20</td><td>0x326c977e6efc84e512bb9c30f76e30c160ed06fb</td><td>1</td><td>LINK</td></tr><tr><td>652</td><td>MERL</td><td></td><td></td><td>0</td><td>BTC</td></tr><tr><td>651</td><td>MERL</td><td></td><td></td><td>0</td><td>MERL</td></tr><tr><td>650</td><td>MERL</td><td>MERL</td><td>0x8ca2f5f38f37d377a320844c38064a0ef97b37e4</td><td>1</td><td>MERL</td></tr><tr><td>203</td><td>NEAR</td><td></td><td></td><td>0</td><td>NEAR</td></tr><tr><td>21</td><td>OKC</td><td></td><td></td><td>0</td><td>OKT</td></tr><tr><td>22</td><td>OKC</td><td>KIP20</td><td>0xda9d14072ef2262c64240da3a93fea2279253611</td><td>1</td><td>OKB</td></tr><tr><td>215</td><td>OP</td><td></td><td></td><td>0</td><td>ETH</td></tr><tr><td>216</td><td>OP</td><td>OPT_ERC20</td><td>0x6b84ad647c8bc943281d67e569f3572570d20d57</td><td>1</td><td>CD</td></tr><tr><td>219</td><td>OP</td><td>OPT_ERC20</td><td>0x94b008aa00579c1307b0ef2c499ad98a8ce58e58</td><td>1</td><td>USDT</td></tr><tr><td>29</td><td>SOL</td><td></td><td></td><td>0</td><td>SOL</td></tr><tr><td>100</td><td>SOL</td><td>SPL</td><td>4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU</td><td>1</td><td>USDC</td></tr><tr><td>703</td><td>SONIC</td><td></td><td></td><td>0</td><td>SONIC</td></tr><tr><td>704</td><td>SONIC</td><td>SONIC_ERC20</td><td>0xaf93888cbd250300470a1618206e036e11470149</td><td>1</td><td>CORAL</td></tr><tr><td>660</td><td>TON</td><td></td><td></td><td>0</td><td>TON</td></tr><tr><td>679</td><td>TON</td><td>JETTON</td><td>EQC9GzFiNQ2Cygp2V2IDxQlFsbmtJbFXEbpc0QwyudyAfQZ</td><td>1</td><td>CDC</td></tr><tr><td>3</td><td>TRX</td><td></td><td></td><td>0</td><td>TRX</td></tr><tr><td>166</td><td>TRX</td><td>TRC20</td><td>TXLAQ63Xg1NAzckPwKHvzw7CSEmLMEqcdj</td><td>1</td><td>USDT</td></tr><tr><td>5</td><td>TRX</td><td>TRC20</td><td>TJwXPRrs39c9apaGsjccv7XiybkvYaLUhn</td><td>1</td><td>UT</td></tr><tr><td>699</td><td>WYZ</td><td></td><td></td><td>0</td><td>WYZ</td></tr><tr><td>700</td><td>WYZ</td><td>WRC20</td><td>0x32af4671788db409bbc87b7e7df038349b17f1e1</td><td>1</td><td>WYS</td></tr><tr><td>27</td><td>XDAI</td><td></td><td></td><td>0</td><td>XDAI</td></tr><tr><td>28</td><td>XDAI</td><td>XDAI_ERC20</td><td>0x3111c94b9243a8a99d5a867e00609900e437e2c0</td><td>1</td><td>FAU</td></tr><tr><td>214</td><td>XLM</td><td></td><td></td><td>0</td><td>XLM</td></tr><tr><td>30</td><td>XRP</td><td></td><td></td><td>0</td><td>XRP</td></tr><tr><td>617</td><td>XYM</td><td></td><td></td><td>0</td><td>XYM</td></tr><tr><td>12</td><td>ZEC</td><td></td><td></td><td>0</td><td>ZEC</td></tr></tbody></table>

## 请求API <a href="#api" id="api"></a>

快速了解如何请求 CoinsDo API。

### **请求方式**

* POST

### **请求参数**

* Header 参数

<table><thead><tr><th width="153.33333333333331">参数名</th><th width="73">必填</th><th>类型/参数值</th></tr></thead><tbody><tr><td>Content-Type</td><td>是</td><td>application/json</td></tr></tbody></table>

* Body 参数

<table><thead><tr><th width="152">参数名</th><th width="73">必填</th><th width="152">类型</th><th>说明</th></tr></thead><tbody><tr><td>sign</td><td>是</td><td>string</td><td>签名</td></tr><tr><td>data</td><td>是</td><td>string</td><td>内容（JSON字符串,具体看每个接口详情定义）</td></tr></tbody></table>

* 签名规则

签名使用HMAC-SHA256算法。

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

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

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

### **响应参数**

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

### **状态码**

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

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

## **回调通知**

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

### 回调场景 <a href="#undefined" id="undefined"></a>

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

<table><thead><tr><th width="181">回调场景</th><th width="392">描述</th><th>建议</th></tr></thead><tbody><tr><td>下发</td><td>下发请求链上交易(成功/驳回/取消）</td><td>处理</td></tr><tr><td>归集收币一个确认</td><td>存币后链上达到一个确认数(中间状态)</td><td>处理/忽略</td></tr><tr><td>归集收币到账</td><td>达到指定确认数&#x26;核查成功(最终状态)入账</td><td>处理</td></tr></tbody></table>

### **请求方式**

* POST

### **请求参数**

* Header 参数

<table><thead><tr><th width="153.33333333333331">参数名</th><th width="73">必填</th><th>类型/参数值</th></tr></thead><tbody><tr><td>Content-Type</td><td>是</td><td>application/json</td></tr></tbody></table>

* Body 参数

<table><thead><tr><th width="154">参数名</th><th width="75">必填</th><th width="151">类型</th><th>说明</th></tr></thead><tbody><tr><td>sign</td><td>是</td><td>string</td><td>签名</td></tr><tr><td>data</td><td>是</td><td>string</td><td>内容（JSON字符串）</td></tr></tbody></table>

### **返回示例**

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

## 获取当前矿工费

可通过此API查询某一币种的当前矿工费

### **接口描述**

* 查询某一币种的当前矿工费

### **请求地址**

* `{URL}/v1/txFeeGet`

### **请求方式**

* POST
* Body 参数

<table><thead><tr><th width="169">参数名</th><th width="81">必填</th><th width="110">类型</th><th>说明</th></tr></thead><tbody><tr><td>data</td><td>是</td><td>string</td><td>内容（JSON字符串，如下）</td></tr></tbody></table>

```json
{
    "apiKey": "aa465953d55641b3", 
    "coinsDoId": "25", 
    "timestamp": "2847982343622"
}
```

* data 参数

<table><thead><tr><th width="179">参数名</th><th width="83">必填</th><th width="108">类型</th><th>说明</th></tr></thead><tbody><tr><td>apiKey</td><td>是</td><td>string</td><td>API KEY</td></tr><tr><td>coinsDoId</td><td>是</td><td>string</td><td>币种ID(参数见币种列表)</td></tr><tr><td>timestamp</td><td>是</td><td>string</td><td>时间戳(秒或毫秒)</td></tr></tbody></table>

### **请求示例**

```json
{
    "data": "{\"apiKey\":\"aa465953d55641b3\",\"coinsDoId\":\"25\",\"timestamp\":\"2847982343622\"}",
    "sign": "b7452bd73629ac1ddaae1096a1257a8a70262450b23c95f6c5f199d631d97486"
}
```

### **返回示例**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "transFee": "0.000021525084",
        "updateTime": "1748329922"
    }
}
```

<table><thead><tr><th width="215">参数名</th><th width="83">必填</th><th width="109">类型</th><th>说明</th></tr></thead><tbody><tr><td>transFee</td><td>是</td><td>string</td><td>币种的矿工费</td></tr><tr><td>updateTime</td><td>是</td><td>string</td><td>矿工费更新时间戳(秒)</td></tr></tbody></table>

## 获取各链当前高度

### **接口描述**

* 查询各链当前高度

### **请求地址**

* `{URL}/v1/blockNumberGet`

### **请求方式**

* POST

### **请求示例**

```json
{
    "data": "{\"apiKey\":\"aa465953d55641b3\",\"timestamp\":\"2847982343622\"}",
    "sign": "7639a6a58d8ae74db48db3841f71a21b92e68131529c5e4d72ef4baa6234146b"
}
```

### **返回示例**

```json
{
    "success": true,
    "code": 200,
    "msg": "Success",
    "data": {
        "blockNumberList": [
            {
                "currency": "ADA",
                "latestNumber": "4369683",
                "scanNumber": "4369683",
                "active": true,
                "lastScanTime": 1769655690644,
                "safeRange": "60"
            },
            {
                "currency": "ALGO",
                "latestNumber": "55887257",
                "scanNumber": "42367464",
                "active": true,
                "lastScanTime": 1758329493326,
                "safeRange": "60"
            },
            {
                "currency": "ARB1",
                "latestNumber": "237774612",
                "scanNumber": "55797388",
                "active": true,
                "lastScanTime": -1,
                "safeRange": "60"
            },
            {
                "currency": "ARB1_ERC20",
                "latestNumber": "237774612",
                "scanNumber": "55554107",
                "active": true,
                "lastScanTime": -1,
                "safeRange": "60"
            },
            {
                "currency": "ATOM",
                "latestNumber": "15751831",
                "scanNumber": "22760797",
                "active": true,
                "lastScanTime": -1,
                "safeRange": "60"
            },
            {
                "currency": "AVAXC",
                "latestNumber": "51237230",
                "scanNumber": "51237221",
                "active": true,
                "lastScanTime": 1769655722436,
                "safeRange": "60"
            },
            {
                "currency": "AVAXC_ERC20",
                "latestNumber": "51237230",
                "scanNumber": "51237222",
                "active": true,
                "lastScanTime": 1769655723546,
                "safeRange": "60"
            },
            {
                "currency": "BCH",
                "latestNumber": "1695283",
                "scanNumber": "1695283",
                "active": true,
                "lastScanTime": 1769655361665,
                "safeRange": "60"
            },
            {
                "currency": "BNB",
                "latestNumber": "87175235",
                "scanNumber": "72655277",
                "active": true,
                "lastScanTime": 1769655725450,
                "safeRange": "60"
            },
            {
                "currency": "BEP20",
                "latestNumber": "87175235",
                "scanNumber": "69815464",
                "active": true,
                "lastScanTime": 1769655735952,
                "safeRange": "60"
            },
            {
                "currency": "BSV",
                "latestNumber": null,
                "scanNumber": null,
                "active": false,
                "lastScanTime": null,
                "safeRange": null
            },
            {
                "currency": "BTC",
                "latestNumber": "4325100",
                "scanNumber": "4325100",
                "active": true,
                "lastScanTime": 1769655122180,
                "safeRange": "3"
            },
            {
                "currency": "OMNI",
                "latestNumber": null,
                "scanNumber": null,
                "active": false,
                "lastScanTime": null,
                "safeRange": null
            },
            {
                "currency": "DASH",
                "latestNumber": "1410759",
                "scanNumber": "1410759",
                "active": true,
                "lastScanTime": 1769655480937,
                "safeRange": "60"
            },
            {
                "currency": "DOGE",
                "latestNumber": "31944480",
                "scanNumber": "31944306",
                "active": true,
                "lastScanTime": 1769655736382,
                "safeRange": "60"
            }
        ],
        "timestamp": "2026-01-29T03:02:16.407+00:00"
    }
}
```

* data 参数

<table><thead><tr><th width="179">参数名</th><th width="83">必填</th><th width="108">类型</th><th>说明</th></tr></thead><tbody><tr><td>blockNumberList</td><td>是</td><td>Array</td><td>区块高度列表</td></tr><tr><td>timestamp</td><td>是</td><td>String</td><td>时间戳(秒或毫秒)</td></tr></tbody></table>

* blockNumberList 参数

<table><thead><tr><th width="179">参数名</th><th width="83">必填</th><th width="108">类型</th><th>说明</th></tr></thead><tbody><tr><td>currency</td><td>是</td><td>String</td><td>币种</td></tr><tr><td>latestNumber</td><td>否</td><td>String</td><td>当前链上最新高度</td></tr><tr><td>scanNumber</td><td>否</td><td>String</td><td>CoinsDo扫块高度</td></tr><tr><td>active</td><td>否</td><td>Boolean</td><td>true - 系统开启了对该币种扫快<br>false - 系统对该币种没有扫快</td></tr><tr><td>lastScanTime</td><td>否</td><td>Interger</td><td>CoinsDo上次扫描时间</td></tr><tr><td>safeRange</td><td>否</td><td>String</td><td>安全间隔（ latestNumber 和 scanNumber 的差值在安全间隔数值以内的话表示扫块正常）<br>注明：未支援safeRange的币种显示 null</td></tr></tbody></table>

### **返回状态码**

<table><thead><tr><th width="179">状态码</th><th>说明</th></tr></thead><tbody><tr><td>4099</td><td>请求次数太频繁</td></tr></tbody></table>

## 商户查询账户下所有客户端在线状态API

### **接口描述**

* 查询商户所有装置的在线状态

### **请求地址**

* `{URL}/v1/onlineDeviceList`

### **请求方式**

* POST
* Body 参数

<table><thead><tr><th width="117.94921875">参数名</th><th width="150.10546875">必填</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td>data</td><td>是</td><td>string</td><td>内容（JSON字符串，如下）</td></tr></tbody></table>

```json
{
    "apiKey": "7bb52d79e46e47ab",
    "timestamp": "1744697998"
}
```

* data 参数

<table><thead><tr><th width="130.25">参数名</th><th width="109.26171875">必填</th><th width="144.1015625">类型</th><th>说明</th></tr></thead><tbody><tr><td>apiKey</td><td>是</td><td>string</td><td>API KEY</td></tr><tr><td>timestamp</td><td>是</td><td>string</td><td>时间戳 (秒或毫秒)</td></tr></tbody></table>

### **请求示例**

```json
{
    "data":"{\"apiKey\":\"7bb52d79e46e47ab\",\"timestamp\":\"1744697998\"}",
    "sign":"03dabf4073bad9d5fcde3b881bba076cae211ac28b11995289740f96f51162a5"
}
```

### 返回示例

```json
{
    "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 参数

<table><thead><tr><th width="142.6640625">参数名</th><th width="115.4609375">必填</th><th width="149.91796875">类型</th><th>说明</th></tr></thead><tbody><tr><td>deviceName</td><td>是</td><td>string</td><td>设备名称</td></tr><tr><td>deviceUuid</td><td>是</td><td>string</td><td>设备UUID</td></tr><tr><td>deviceType</td><td>是</td><td>Integer</td><td>设备类型（0.下发 1.归集）</td></tr><tr><td>onlineStatus</td><td>是</td><td>Integer</td><td>在线状态（0.离线 1.在线）</td></tr></tbody></table>

### **返回状态码**

<table><thead><tr><th width="121.7109375">状态码</th><th>说明</th></tr></thead><tbody><tr><td>4002</td><td>参数格式错误</td></tr><tr><td>4003</td><td>JSON数据转换异常</td></tr><tr><td>4004</td><td>APIKEY不存在</td></tr><tr><td>4005</td><td>ip受限，当前ip:</td></tr><tr><td>4007</td><td>验签失败</td></tr><tr><td>4010</td><td>请求过期</td></tr><tr><td>4068</td><td>检查APIKEY失败</td></tr><tr><td>4099</td><td>请求次数太频繁</td></tr><tr><td>4143</td><td>查询在线设备失败</td></tr><tr><td>4144</td><td>查询归集在线设备失败</td></tr><tr><td>4145</td><td>查询商户设备失败</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://coinsdo.gitbook.io/docs/cn/coinsdo-api-integration/coinsdo-api-jie-ru-wen-dang/tong-ze.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.