EmpoEX API Documentation

API Documentation

The follow documentation is regarding the usage and examples of the Public API for EmpoEX.

EmpoEX provides a JSON API as an easy way to integrate data into your applications. This is provided over HTTPS and returned as application/json.

The base URL for every request is https://api.empoex.com/[request].

Public Methods

We offer the following Public API methods.

GET /marketinfo

Get all info on market data. Use market parameters to get specific market info.


Parameters
None Required (optional: MARKET-BASE)

Request URL
https://api.empoex.com/marketinfo/[optional parameter]

Example Result


[  
   {  
      "pairname":"XCASH-BTC",
      "last":"0.00000000",
      "base_volume_24hr":"0.00000000",
      "low":"0.00000000",
      "high":"0.00000000",
      "bid": "0.00000000",
      "ask": "0.00000000",
      "open_buy_volume": "0.00000000",
      "open_sell_volume": "0.00000000",
      "open_buy_volume_base": "0.00000000",
      "open_sell_volume_base": "0.00000000",
      "change":"0.00%"
   },
   {  
      "pairname":"LOG-LTC",
      "last":"0.00000000",
      "base_volume_24hr":"0.00000000",
      "low":"0.00000000",
      "high":"0.00000000",
      "bid": "0.00000000",
      "ask": "0.00000000",
      "open_buy_volume": "0.00000000",
      "open_sell_volume": "0.00000000",
      "open_buy_volume_base": "0.00000000",
      "open_sell_volume_base": "0.00000000",
      "change":"0.00%"
   }
]
					

GET /markethistory

Get all market trade history. Use market parameters to get specific market history.


Parameters
None Required (optional: MARKET-BASE)

Request URL
https://api.empoex.com/markethistory/[optional parameter]

Example Result


{  
   "ETD-BTC":[  
      {  
         "type":"Buy",
         "date":1415278001,
         "amount":"1000.00000000",
         "price":"0.00004000",
         "total":"0.04000000"
      },
      {  
         "type":"Buy",
         "date":1415277994,
         "amount":"841.01487000",
         "price":"0.00003999",
         "total":"0.03363218"
      }
   ],
   "ICNX-BTC":[  
      {  
         "type":"Sell",
         "date":1415240139,
         "amount":"5004.54507727",
         "price":"0.00000111",
         "total":"0.00555505"
      },
      {  
         "type":"Sell",
         "date":1415207194,
         "amount":"5103.03300000",
         "price":"0.00000111",
         "total":"0.00566437"
      }
   ]
}
					

GET /orderbook

Get all open orderbook data for buys/sells. Use market parameters to get specific market orderbook data.


Parameters
None Required (optional: MARKET-BASE)

Request URL
https://api.empoex.com/orderbook/[optional parameter]

Example Result


{  
   "ETD-BTC":{  
      "sell":[  
         {  
            "amount":"1658.98510000",
            "price":"0.00004499",
            "total":"0.07463773"
         },
         {  
            "amount":"1060.11400000",
            "price":"0.00004500",
            "total":"0.04770513"
         }
      ],
      "buy":[  
         {  
            "amount":"9980.00665333",
            "price":"0.00003000",
            "total":"0.29940019"
         },
         {  
            "amount":"11474.68041638",
            "price":"0.00002930",
            "total":"0.33620813"
         }
      ]
   }
}
					


BETA Trade Methods

Private API methods require an API key to be used. This key can be obtained from inside your account Settings here.

We offer the following Private Trade API methods.

GET /trade/openorders

Get all open orders on your account. Use market parameters to get specific market orders, or specify an order number directly to retrieve a specific open order.


Parameters
API KEY
(optional: MARKET-BASE)
(optional: ORDER ID)

Request URL
https://api.empoex.com/trade/openorders/[API KEY]/[optional parameter]

Example Result


{
	"LTC-BTC": [
		{
			"order_id": 262,
			"amount_remaining": "200.00000000",
			"original_amount": "500.00000000",
			"value": "0.00020000",
			"type": "Buy"
		},
		{
			"order_id": 261,
			"amount_remaining": "100.00000000",
			"original_amount": "100.00000000",
			"value": "0.00010000",
			"type": "Buy"
		}
	]
}
					


GET /trade/cancel

Cancel an open order.


Parameters
API KEY
ORDER ID

Request URL
https://api.empoex.com/trade/cancel/[API KEY]/[ORDER ID]

Example Result


{
	"success": true
}
					

Success will be false for a failed call.


GET /trade/buy

Create a Buy order in a specific market.

Note: This call takes longer to process than regular API calls.


Parameters
API KEY
MARKET-BASE
QUANTITY
PRICE

Request URL
https://api.empoex.com/trade/buy/[API KEY]/[MARKET-BASE]/[QUANTITY]/[PRICE]

Example Result


{
	"success": true,
	"message": "Order submitted for processing",
	"order_id": 340
}
					

Success will be false for a failed call.


GET /trade/sell

Create a Sell order in a specific market.

Note: This call takes longer to process than regular API calls.


Parameters
API KEY
MARKET-BASE
QUANTITY
PRICE

Request URL
https://api.empoex.com/trade/sell/[API KEY]/[MARKET-BASE]/[QUANTITY]/[PRICE]

Example Result


{
	"success": true,
	"message": "Order submitted for processing",
	"order_id": 340
}
					

Success will be false for a failed call.


BETA Account Methods

Private API methods require an API key to be used. This key can be obtained from inside your account Settings here.

We offer the following Private Account API methods.

GET /account/balance

Get all balances on your account; available, pending and held.


Parameters
API KEY
(optional: COIN)

Request URL
https://api.empoex.com/account/balance/[API KEY]/[optional parameter]

Example Result


{
	"available": [
		{
			"Coin": "BTC",
			"Amount": "1.75144263"
		},
		{
			"Coin": "LTC",
			"Amount": "7.81908436"
		}
	],
	"pending": [
		{
			"Coin": "BTC",
			"Amount": "1.00000000"
		}
	],
	"held": [
		{
			"Coin": "BTC",
			"Amount": "0.00075911"
		}
	]
}
						


GET /account/depositaddress

Get deposit addresses for your account.


Parameters
API KEY
(optional: COINNAME or COINACRONYM)

Request URL
https://api.empoex.com/account/depositaddress/[API KEY]/[optional parameter e.g. Bitcoin or BTC]

Example Result


{
	"BTC": {
		"address": "15Z7YegMRGAKiswJKbDh9vxHueREayesFM",
		"coin_name": "BitCoin"
	},
	"DRK": {
		"address": "Xas36o2tqQKjk6Z1dUv6UDYXxioLPpXZWq",
		"coin_name": "DarkCoin"
	},
	"LTC": {
		"address": "La5uh3WDbRtb1YoCw53uX1CzWwMefG9486",
		"coin_name": "LiteCoin"
	}
}
						


BETA GET /account/generatedepositaddress

Generate a new deposit address for your account.


Parameters
API KEY
COINACRONYM

Request URL
https://api.empoex.com/account/generatedepositaddress/[API KEY]/[COINACRONYM]

Example Result


{
	"success": true,
	"message": "Successfully generated new LTC address",
	"deposit_address": "LdgwFiad38VXrCvqcsnuujGsqHKoDFkJvY"
}
						


GET /account/deposithistory

Get history of deposits into your account.


Parameters
API KEY
(optional: COINACRONYM)

Request URL
https://api.empoex.com/account/deposithistory/[API KEY]/[optional parameter]

Example Result


{
	"LTC": [
		{
			"amount": "47.62083485",
			"date": 1420375386,
			"id": "ba7d531686b257c6d373e6h2702d27f37dc18c1ddc82efca222bb3be6f1fcb5f",
			"paid": 1,
			"address": "La1PPgnFaW8RBoklcvFuAYUoPRbuPMas2m",
			"confirmed": 1
		}
	]
}
						


GET /account/withdrawhistory

Get history of withdraws from your account.


Parameters
API KEY
(optional: COINACRONYM)

Request URL
https://api.empoex.com/account/withdrawhistory/[API KEY]/[optional parameter]

Example Result


{
	"BTC": [
		{
			"amount": "0.01",
			"date": 1417614898,
			"txid": "TXIDHERE",
			"address": "ADDRESSHERE",
			"confirmed": "1"
		}
	]
}
						


GET /account/withdraw

Withdraw coins from your account.


Parameters
API KEY
COINACRONYM
ADDRESS
AMOUNT
UNIQUE IDENTIFIER (please contact support to obtain this)

Request URL
https://api.empoex.com/account/withdraw/[API KEY]/[COINACRONYM]/[ADDRESS]/[AMOUNT]/[UNIQUE IDENTIFIER]

Example Result


{
	"success": "true",
	"message": "Withdrawal successfully added to queue"
}
						


GET /account/events

Get account event notifications.


Parameters
API KEY

Request URL
https://api.empoex.com/account/events/[API KEY]

Example Result


[
	{
		"message": "7.42658165 BTC sold",
		"date": 1421604385,
		"read": 1
	},
	{
		"message": "10.63316669 LTC bought",
		"date": 1421603906,
		"read": 1
	}
]
						

Note Limited to last 1000 events.

Check our Twitter @EmpoExchange for updates on new API features.