Coins-E trade API documentation

Public data

Wallet

Orders

Examples

Get Started

Coins-E trade API lets you to trade over 30 coins.

To get started get your public/private keys

.

Important:

The response from the server is in standard JSON format. There are three params which are returned with every request.

status[true/false] the value is true if the request successfully performed what was intended, returns false if it did not.
messageIf the status is false, 'message' carries the error information.
systimeUnix epoch system time corresponding to when the request was proceesed.

Public requests (no authentication required):

1. List of markets available
URL:https://www.coins-e.com/api/v2/markets/list/
HTTP Method:GET
Description:List of all markets available including the status and the trade fee. Trading is allowed only if the status of the market is healthy
Request Params:None
Example Response:
2. List of coins
URL:https://www.coins-e.com/api/v2/coins/list/
HTTP Method:GET
Description:List of all coins listed on the exchange including the status and the trade fee. Withdrawals and deposits are processed only if the coin is healthy.
Request Params:None
Example Response:
3. Market Information: Consolidated Market data
URL format:https://www.coins-e.com/api/v2/markets/data/
HTTP Method:GET
Description:Returns a consolidated list of all markets. The return data includes market stats and also the market depth
Request Params:None
Response:
In the marketstat area




In the asks/bids list



Example Response:
4. Market Information: Depth (open orders)
URL format:https://www.coins-e.com/api/v2/market/[ pair ]/depth/
Example URL:https://www.coins-e.com/api/v2/market/WDC_BTC/depth/
HTTP Method:GET
Description:Returns lists of asks and bids corresponding to the given pair.
Request Params: Pair: is in the format of C1_C2, where C1 is the first coin's three letter abbrevation and C2 is the second coin's three letter abbrevation. Eg. WDC_BTC
Response:
In the asks/bids list



Example Response:
5. Market Information: Recent trades
URL format:https://www.coins-e.com/api/v2/market/[ pair ]/trades/
Example URL:https://www.coins-e.com/api/v2/market/WDC_BTC/trades/
HTTP Method:GET
Description:Returns lists of recent trades corresponding to the given pair.
Request Params: 'Pair': is in the format of C1_C2, where C1 is the first coin's three letter abbrevation and C2 is the second coin's three letter abbrevation. Eg. WDC_BTC
Example Response:

User specific requests (authentication required):

  • All authenticated requests should be POST requests.
  • All requests should carry a nonce parameter and it should be incremented for every subsequent request.
  • You can obtain your public/private keys required for authenticated requests from the API access page.
  • All requests should include 'key' as a query string parameter which is your public key
  • The POST data should be HMAC SHA-512 signed using your secret key obtained from API access page. The 'sign' should be included in the query string.

Wallet

Each Coin has a seperate wallet. Currently withdrawals are not possible via the API.

Coin parameter used in the URL is a three letter abbrevation of the coin. Eg. BTC denotes Bitcoin, WDC denotes Worldcoin.

6. Wallet: getallwallets
URL Format:https://www.coins-e.com/api/v2/wallet/all/
Example URL:https://www.coins-e.com/api/v2/wallet/all/
HTTP method:POST
POST parameters:
methodgetwallets
nonceA security integer, should be incremented for every subsequent request.
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Returns all wallets including funds available for trade, funds on hold and unconfimed funds.
Example Response:
6. Wallet: getwallet
URL Format:https://www.coins-e.com/api/v2/wallet/ [ coin ] /
Example URL:https://www.coins-e.com/api/v2/wallet/BTC/
HTTP method:POST
POST parameters:
methodgetwallet
nonceA security integer, should be incremented for every subsequent request.
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Returns the wallet of the requested coin including funds available for trade, funds on hold and unconfimed funds.
Example Response:
7. Wallet: getdepositaddress
URL Format:https://www.coins-e.com/api/v2/wallet/ [ coin ] /
Example URL:https://www.coins-e.com/api/v2/wallet/BTC/
HTTP method:POST
POST parameters:
methodgetdepositaddress
nonceA security integer, should be incremented for every subsequent request.
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Returns a deposit address for the requested coin.
Example Response:
8. Wallet: updatewallet
URL Format:https://www.coins-e.com/api/v2/wallet/ [ coin ] /
Example URL:https://www.coins-e.com/api/v2/wallet/BTC/
HTTP method:POST
POST parameters:
methodupdatewallet
nonceA security integer, should be incremented for every subsequent request.
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:If a deposit was made and if the deposit is yet to reflect in your wallet, requesting an 'updatewallet' forces the servers to check your wallet for new deposits.
Example Response:

Orders

Pair: is in the format of C1_C2, where C1 is the first coin's three letter abbrevation and C2 is the second coin's three letter abbrevation. Eg. WDC_BTC denotes worldcoin vs bitcoin

Understand the order workflow. Please understand that orders are not executed immiediately when the order is placed, they are placed in a queue and executed using a FIFO model.

Order work flow
9. Order: neworder
URL Format:https://www.coins-e.com/api/v2/market/ [ pair ] /
Example URL:https://www.coins-e.com/api/v2/market/WDC_BTC/
HTTP method:POST
POST parameters:
methodneworder
nonceA security integer, should be incremented for every subsequent request.
order_type[ buy/sell ]
rateEg. 0.002312 (max 8 decimals) (in terms of C2)
quantityEg. 0.002312 (max 8 decimals) (in terms of C1)
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Submit a new order to the market.
Example Response:
10. Order: getorder
URL Format:https://www.coins-e.com/api/v2/market/ [ pair ] /
Example URL:https://www.coins-e.com/api/v2/market/WDC_BTC/
HTTP method:POST
POST parameters:
methodgetorder
nonceA security integer, should be incremented for every subsequent request.
order_idEg. B/0.00212300/5517761665040384
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Returns a single order corresponding to the order id.
Example Response:
11. Order: cancelorder
URL Format:https://www.coins-e.com/api/v2/market/ [ pair ] /
Example URL:https://www.coins-e.com/api/v2/market/WDC_BTC/
HTTP method:POST
POST parameters:
methodcancelorder
nonceA security integer, should be incremented for every subsequent request.
order_idEg. B/0.00212300/5517761665040384
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Requests the order corresponding to the order id to be cancelled.
Example Response:
12. Order: listorders
URL Format:https://www.coins-e.com/api/v2/market/ [ pair ] /
Example URL:https://www.coins-e.com/api/v2/market/WDC_BTC/
HTTP method:POST
POST parameters:
methodlistorders
nonceA security integer, should be incremented for every subsequent request.
filter(optional) [ active/all ] Defaults to active

active:Returns orders that are active (cancelled and fully executed orders are not returned.

all:Returns all orders.
cursor(optional) List traversal is implemented using a cursor, a cursor is returned with the request if there are more orders than that have been returned. Use the cursor in the subsequent request to get the next set of orders.
limit(optional) Defaults to 20. Number of orders to be returned in the request. (Maximum is 100)
Query string parameters:
keyYour public key
signHMAC SHA-512 POST data signature
Description:Returns a list of orders assosiated with your account on the specified market.
Example Response:

API usage Examples

Python
Python Coins E API client example