English

📗General

Below is the general information regarding our API URL and the tokens supported.

API URL

Make sure to use the correct API URL corresponding to the account you are using. To verify, please check your current login URL based on below.

Mainnet: https://merchant.coinsdo.com Testnet: https://merchant.coinsdotest.com/

Supported Networks

This is a list of networks we currently support. The code can be used as the value in 'chain' parameter in/v1/addressGet endpoint.

Supported Tokens

Please refer to the currency control list in your CoinSend/CoinGet center for the most up-to-date coinsDoId.

Mainnet

Testnet

How to make API request

Below are the standard rules for making an API request with the CoinsDo Open API.

Request parameters

  • Header parameter

  • Body parameter

Signing

The signature is generated using the HMAC-SHA256 algorithm. The Secret-KEY corresponding to the API-KEY is used as the key for HMAC-SHA256 encryption of the data parameter, and the output obtained is the signature.

The following example shows the signature of the data parameter using a 1024-bit key.

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

Respond

{
  "code": 200, // Status code
  "msg": "Success", // Remarks
  "data": null // Response 
}

Status code

Below is a general list of status codes, and each API endpoint may have its own differences.

Callback notification

Below are the details of the callback request made from CoinsDo to your endpoint.

Request Method

  • POST

Request Parameters

  • Header parameter

  • Body parameters

Return example

{
  "code": 200, // Status code
  "msg": "Success", // Remarks
  "data": null // Response
}

Callback scenario

This section suggests whether you should respond to the callback.

When you execute, the return code should display 200 if the callback is successful. Once it is successful, there will be no further callbacks.

If you choose to ignore, the return code should display 202 if it is successful. There will be no callbacks (Choosing to ignore is similar to the 200 status in terms of effect. The only difference is whether you want to handle the suggested display).

PreviousCoinsDo Open APINextCoinSend

Last updated