📗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/

Environment	URL
Mainnet	https://open.coinsdo.com/coinsdo/open
Testnet	https://open.coinsdotest.com/coinsdo/open

---

Supported Tokens

Please go to currency control list in your CoinSend/CoinGet center for the most up-to-date list of support tokens and also coinsDoId for making API request.

List of supported tokens (Live environment)

coinsDoId	mainnet	protocol	tokenAddress	coinType (0-coin; 1-token)	coinName
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

List of supported tokens (Test environment)

coinsDoId	mainnet	protocol	tokenAddress	coinType (0-coin; 1-token)	coinName
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

---

How to make API request

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

Request parameters

• Header

Parameter	Required	Value
Content-Type	Yes	application/json

• Body

Parameter	Required	Type	Description
sign	Yes	string	Signature
data	Yes	string	Content（JSON string, depends on each API）

Signing

Generate the signature by hashing the data using HMAC-SHA256 with the Secret-KEY linked to your API-KEY or merchant account. The resulting hash is the signature.

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

Response

{
  "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.

Status code	Description
-2	System error
200	Success
4001	API endpoints not found
4002	Parameters in wrong format
4003	JSON data conversion abnormal
4004	API Key does not exists
4005	IP Restricted
4007	Signature verification failed
4010	Request expired
4068	Failed to verify APIKEY

Webhook notification

Below are the details of the webhook requests are sent from CoinsDo to webhook URL.

Request

POST /{webhookURL}

• Header

Parameter	Required	Value
Content-Type	Yes	application/json

• Body

Parameter	Required	Type	Description
sign	Yes	string	Signature
data	Yes	string	Content（JSON string）

Response

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

How you should respond?

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).

Scenario	Example	Suggestion
Transfer	Transfer request on the in CoinSend (success/rejected/cancelled).	Respond with code 200
Receive (confirmed by 1 block)	Transaction confirmed by 1 block.	Respond with code 200 /ignore
Receive (confirm by specific number of blocks)	Target blockchain confirmations have been reached and verified successfully (final status) and credited.	Respond with code 200 and update