Rest API
EXX為用戶提供了一個簡單的而又強大的API，旨在幫助用戶快速高效的將EXX交易功能整合到自己應用當中。
如果在使用過程中有任何問題，請聯係我們技術討論QQ群：630260653[點擊加群] ，我們將為您做出最權威的解答。
獲取EXX最新市場行情數據
| 接口 | 描述 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
+- https://api.exx.com/data/v1/markets
所有市場
示例 //# Request
GET https://api.exx.com/data/v1/markets
//# Response
{
"eos_btc":{
"minAmount":"0.00010",
"amountScale":2,
"priceScale":6,
"maxLevels":0,
"isOpen":false
},
"etc_hsr":{
"minAmount":"0.001",
"amountScale":3,
"priceScale":3,
"maxLevels":0,
"isOpen":true
},
...
}
返回值說明 minAmount : 最小交易金額
amountScale : 買方幣小數點
priceScale : 賣方幣小數點
maxLevels : 最大杠杆倍數，0表示不開放杠杆
isOpen : 是否開盤
|
|||||||||||
+- https://api.exx.com/data/v1/tickers
所有行情
示例 //# Request
GET https://api.exx.com/data/v1/tickers
//# Response
{
"bts_btc":{
"vol":0.0,
"last":0,
"sell":0.0,
"buy":0.0,
"weekRiseRate":0.0,
"riseRate":0.0,
"high":0.0,
"low":0,
"monthRiseRate":0.0
},
...
}
返回值說明 vol : 成交量(最近的24小時)
last : 最新成交價
sell : 賣一價
buy : 買一價
weekRiseRate : 周漲跌幅
riseRate : 24小時漲跌幅
high : 最高價
low : 最低價
monthRiseRate : 30日漲跌幅
|
|||||||||||
+- https://api.exx.com/data/v1/ticker
市場行情
示例 //# Request
GET https://api.exx.com/data/v1/ticker?currency=eth_hsr
//# Response
{
"ticker": {
"vol": "1447.851",
"last": "30.487000000",
"sell": "30.499",
"buy": "30.487",
"weekRiseRate": -1.17,
"riseRate": 9.45,
"high": "30.812",
"low": "27.855",
"monthRiseRate": -0.99
},
"date": "1510383406453"
}
返回值說明 vol : 成交量(最近的24小時)
last : 最新成交價
sell : 賣一價
buy : 買一價
weekRiseRate : 周漲跌幅
riseRate : 24小時漲跌幅
high : 最高價
low : 最低價
monthRiseRate : 30日漲跌幅
請求參數說明
|
|||||||||||
+- https://api.exx.com/data/v1/depth
市場深度
示例 //# Request
GET https://api.exx.com/data/v1/depth?currency=eth_hsr
//# Response
{
"asks": [
[
"32.831",
"0.083"
]...
],
"bids": [
[
"30.434",
"10.766"
]...
],
"timestamp" : 時間戳
}
返回值說明 asks : 賣方深度
bids : 買方深度
timestamp : 此次深度的產生時間戳
請求參數說明
|
|||||||||||
+- https://api.exx.com/data/v1/trades
曆史成交
示例 //# Request
GET https://api.exx.com/data/v1/trades?currency=eth_hsr
//# Response
[
{
"amount" : 0.933,
"price" : 31.595,
"tid" : 2583932,
"type" : "sell",
"date" : 2583932,
"trade_type" : "ask",
}...
]
返回值說明 amount : 交易數量
price : 交易價格
tid : 交易生成ID
type : 交易類型，buy(買)/sell(賣)
date : 交易時間(時間戳)
trade_type : 委托類型，ask(賣)/bid(買)
請求參數說明
|
|||||||||||
+- https://api.exx.com/data/v1/klines
獲取K線
示例 //# Request
https://api.exx.com/data/v1/klines?market=eth_btc&type=1min&size=1&assist=cny
//# Response
{
"datas": {
"limit": 1,
"time": 60,
"symbol": "eth_btc",
"contractUnit": "ETH",
"assistCoin": "btc",
"data": [
[
1529997660000, //时间戳
0.07301, //开盘价
0.07301, //最高价
0.072621, //最低价
0.072621, //收盘价
12.41 //交易量
]
],
"riseRate": 0,
"since": 0,
"type": "1min",
"moneyType": "BTC"
},
"isSuc": true,
"resMsg": {
"message": "SUCCESS",
"code": 1000
}
}
返回值說明 limit : 條數
time : 1min對應的秒數
symbol : 市場名
contractUnit : 賣幣幣種的英文簡稱
assistCoin : 輔助貨幣的英文簡稱
data : kline數據
riseRate ：匯率
since ：開始時間
type ：kline類型
moneyType ：買幣幣種的英文簡稱
請求參數說明
|
|||||||||||
交易API
用於EXX快速進行交易
| 接口 | 描述 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
+- https://trade.exx.com/api/order
委托下單
示例 //# Request
GET https://trade.exx.com/api/order?accesskey=accesskey&amount=1.5¤cy=eth_hsr&nonce=當前時間毫秒數&price=1024&type=buy
&signature=請求加密簽名串
//# Response
{
"code": 100,
"message": "操作成功",
"id": "13877"
}
返回值說明 code : 返回代碼
message : 提示信息
id : 委托掛單號
請求參數說明(加密簽名請根據參數名的首字母順序順序簽名,signature不用加入待簽名字符串)
|
|||||||||||||||||
+- https://trade.exx.com/api/cancel
取消委托
示例 //# Request
GET https://trade.exx.com/api/cancel?accesskey=your_access_key¤cy=eth_hsr&id=123456789&nonce=當前時間毫秒數
&signature=請求加密簽名串
//# Response
{
"code": "100",
"message": "操作成功。"
}
返回值說明 code : 返回代碼
message : 提示信息
請求參數說明(加密簽名請根據這個順序簽名,signature不用加入待簽名字符串)
|
|||||||||||||||||
+- https://trade.exx.com/api/getOrder
獲取委托買單或賣單
示例 //# Request
GET https://trade.exx.com/api/getOrder?accesskey=your_access_key¤cy=eth_hsr&id=123456789&nonce=當前時間毫秒數
&signature=請求加密簽名串
//# Response
{
"fees": 0,
"total_amount": 1,
"trade_amount": 0,
"price": 31,
"currency": “eth_hsr",
"id": "13877",
"trade_money": 0,
"type": "buy",
"trade_date": 1509728383300,
"status": 0
}
返回值說明 fees : 交易手續費
total_amount : 掛單總數量
trade_amount : 已成交數量
price : 單價
currency : 交易市場
id : 委托掛單號
trade_money : 已成交總金額
type: : 掛單類型buy/sell')
trade_date : 時間戳
status : 掛單狀態（0、待成交 1、取消 2、交易完成 3、待成交未交易部分）
請求參數說明(加密簽名請根據這個順序簽名,signature不用加入待簽名字符串)
|
|||||||||||||||||
+- https://trade.exx.com/api/getOpenOrders
獲取多個委托買單或賣單，每次請求返回10條記錄
示例 //# Request
GET https://trade.exx.com/api/getOpenOrders?accesskey=your_access_key¤cy=eth_hsr
&nonce=當前時間毫秒數&pageIndex=1&type=buy&signature=請求加密簽名串
//# Response
[
{
"fees": 0,
"total_amount": 1,
"trade_amount": 0,
"price": 30,
"currency": “eth_hsr",
"id": "13878",
"trade_money": 0,
"type": "buy",
"trade_date": 1509728897772,
"status": 0
},
{
"fees": 0,
"total_amount": 1,
"trade_amount": 0,
"price": 30,
"currency": “eth_hsr",
"id": "13877",
"trade_money": 0,
"type": "buy",
"trade_date": 1509728383300,
"status": 0
}
]
返回值說明 fees : 交易手續費
total_amount : 掛單總數量
trade_amount : 已成交數量
price : 單價
currency : 交易市場
id : 委托掛單號
trade_money : 已成交總金額
type: : 掛單類型 buy/sell
trade_date : 時間戳
status : 掛單狀態（0、待成交 1、取消 2、交易完成 3、待成交未交易部分）
請求參數說明(加密簽名請根據這個順序簽名,signature不用加入待簽名字符串)
|
|||||||||||||||||
+- https://trade.exx.com/api/getBalance
獲取用戶信息
示例 //# Request
GET https://trade.exx.com/api/getBalance?accesskey=your_access_key&nonce=當前時間毫秒數&signature=請求加密簽名串
//# Response
{
"credits": [
{
"flatRatio": "0.1",
"userRatio": "0.0985",
"noticeRatio": "0.2",
"levels": 10,
"flatPrice": 11.01471399
}
],
"funds": {
"BTS": {
"total": "10",
"freeze": "0",
"balance": "10",
"propTag": "BTS",
"credit_quota": "121.938066",
"credit_borrowed": "0",
"credit_interest": "0"
},
"MONA": {
"total": "0.966033",
"freeze": "0.966033",
"balance": "0",
"propTag": "MONA",
"credit_quota": "0",
"credit_borrowed": "0",
"credit_interest": "0"
},
....
"ETH": {
"total": "10",
"freeze": "0",
"balance": "10",
"propTag": "ETH",
"credit_quota": "121.938066",
"credit_borrowed": "0",
"credit_interest": "0"
},
"LTC": {
"total": "0",
"freeze": "0",
"balance": "0",
"propTag": "LTC",
"credit_quota": "121.938066",
"credit_borrowed": "0",
"credit_interest": "0"
},
"QTUM": {
"total": "0.003",
"freeze": "0.003",
"balance": "0",
"propTag": "QTUM",
"credit_quota": "0",
"credit_borrowed": "9.65",
"credit_interest": "0.026252"
}
}
}
返回值說明 credits 借貸信息:
flatRatio : 平倉風險比例, 當用戶風險係數低於此值時，係統執行平倉操作
userRatio : 平倉比例, 用戶風險係數
noticeRatio : 提醒比例,
levels : 杠杆倍數,
flatPrice : 平倉價格
funds(資產信息) :
ETH（ETH資產詳情): {
total : 貨幣總量,
freeze : 凍結數量,
balance : 可用資產,
propTag : 貨幣標識,
credit_quota : 借款額度,
credit_borrowed : 已使用額度,
credit_interest : 未支付利息
}
...
QTUM（QTUM資產詳情): {
total : 貨幣總量,
freeze : 凍結數量,
balance : 可用資產,
propTag : 貨幣標識,
credit_quota : 借款額度,
credit_borrowed : 已使用額度,
credit_interest : 未支付利息
}
|
|||||||||||||||||
+- https://trade.exx.com/api/getChargeAddress
獲取充值地址
示例 //# Request
GET https://trade.exx.com/api/getChargeAddress?accesskey=your_access_key¤cy=qtum&nonce=當前時間毫秒數&signature=請求加密簽名串
//# Response
{
"code":100,
"message" : {
"des" : "success",
"isSuc" : true,
"datas" : {
"currency":"qtum",
"key":"QSWnWqpHiM7Rz2S4Ybf76seYNURPL3Z5TN"
}
}
}
返回值說明 code : 返回代碼
message : 提示信息:
des : 提示信息:
isSuc : 提示信息:
data :{
key : 充值地址,
currency : 貨幣標識
}
|
+- https://trade.exx.com/api/getChargeRecord
獲取充值記錄
示例 //# Request
GET https://trade.exx.com/api/getChargeRecord?accesskey=your_access_key¤cy=qtum&nonce=當前時間毫秒數&pageIndex=頁數&signature=請求加密簽名串
//# Response
{
"code":100,
"message":{
"des": "success",
"isSuc": true,
"datas": {
"total":2,
"pageSize":10,
"list":[{
"amount":11.000000000,
"status":"-",
"hash":"2018013019033000098753290",
"submit_time":"2018-01-30 19:03:31"
"confirmTimes":1
},
{
"amount":11.000000000,
"status":"-",
"hash":"2018013018533000050778882",
"submit_time":"2018-01-30 18:53:31"
"confirmTimes":1
},
"pageIndex":1
}
}
}
返回值說明 code : 返回代碼
message : 提示信息:
des : 提示信息:
isSuc:提示信息:
data:{
total : 記錄數,
status : 充值狀態,
hash : 充值交易號
submit_time : 充值時間,
confirmTimes: 確認數
}
|
||||||||||||||||
+- https://trade.exx.com/api/getWithdrawAddress
獲取認證提幣地址
示例 //# Request
GET https://trade.exx.com/api/getWithdrawAddress?accesskey=your_access_key¤cy=qtum&nonce=當前時間毫秒數&signature=請求加密簽名串
//# Response
{
"code":100,
"message":{
"des": "success",
"isSuc": true,
"datas": [{
"memo":"备注信息",
"key":"QSWnWqpHiM7Rz2S4Ybf76seYNURPL3Z5TN",
"currency":"qtum"
}]
}
}
返回值說明 code : 返回代碼
message : 提示信息:
des :
isSuc:
data:[{
memo : 備注,
key : 提幣地址地址,
currency : 貨幣標識
}]
|
|||||||||||||||||
+- https://trade.exx.com/api/getWithdrawRecord
獲取提幣記錄
示例 //# Request
GET https://trade.exx.com/api/getWithdrawRecord?accesskey=your_access_key¤cy=qtum&nonce=當前時間毫秒數&pageIndex=頁數&signature=請求加密簽名串
//# Response
{
"code":100,
"message":{
"des": "success",
"isSuc": true,
"datas": {
"pageSize":10,
"list":[{
"amount":11.00000000,
"id":2018013084703,
"status":"success",
"submitTime":1517310691000,
"manageTime":1517310812000,
"receive":11.00000000,
"toAddress":"QjedNoj5cU6M5Vv5ipWoPtZEebWBXskYnu"
},{
"amount":11.00000000,
"id":2018013084684,
"status":"success",
"submitTime":1517309701000,
"manageTime":1517309912000,
"receive":11.00000000,
"toAddress":"QjedNoj5cU6M5Vv5ipWoPtZEebWBXskYnu"
}]
,"pageIndex":1
}
}
}
返回值說明 code : 返回代碼
message : 提示信息:
des : 提示信息:
isSuc : 提示信息:
data :{
pageSize:每頁記錄數,
list:
amount : 提幣數量,
id : 提幣記錄ID,
status : 狀態,
submitTime : 提交時間,
manageTime : 處理時間,
receive : 到賬金額,
toAddress : 提幣地址
}
|
|||||||||||||||||
+- https://trade.exx.com/api/withdraw
提幣
示例 //# Request
GET https://trade.exx.com/api/withdraw?accesskey=your_access_key&amount=10¤cy=qtum&nonce=當前時間毫秒數&receiveAddr=提幣地址&safePwd=提幣密碼&signature=請求加密簽名串
//# Response
{
"code":100,
"message":"success",
"id":"2018013084703"
}
返回值說明 code : 返回代碼
message : 提示信息
id : 提幣單號
|
|||||||||||||||||
示例代碼
簽名方式：根據secretkey把請求的參數簽名，請求參數按照ascii值排序加密
//......
try{
//......
String params = "accesskey=yourAccessKey&nonce="+System. currentTimeMillis();
String secretKey = "yourSecretKey";
String baseURL = "https://trade.exx.com/api/getBalance";
String signature = HmacSHA512(params, secretKey);
String url = baseURL + "?" + params + "&signature=" + signature;
String result = doRequest(url);
//String params = "accesskey=yourAccessKey&nonce=1234567890123";
//String secretKey = "yourSecretKey";
//通過HmacSHA512加密的結果為:
//c247be4b0b3f448254e70d422d199c874afa8fe873fd25d39cc1d14e4d60700bdbe0ea681a57bf772a8c16706e8a4d4bef3cd362fcc89f03a15e7e1b9e1930b1
//......
}catch(Exception ex){
ex.printStackTrace();
}
//......
常見問題
訪問限製
1.單個IP限製每分鍾1000次訪問，超過1000次將被鎖定1小時，一小時後自動解鎖。
2.每個市場限製每秒鍾10次訪問，一秒鍾內10次以上的請求，將會視作無效
3.資產接口每秒最多支持訪問3次。
4.充提地址、充提記錄接口每秒最多可訪問1次。
5.提幣權限需要在生成API密鑰操作中開啟,默認不開啟。
6.子賬號不允許提幣操作。