API支持

HPX.WORLD为用户提供了一个简单的而又强大的API，旨在帮助用户快速高效的将hpx.world交易功能整合到自己应用当中。

如果在使用过程中有任何问题，请联系我们技术讨论QQ群：361145004，我们将为您做出最权威的解答。

一、行情API

1、获取HPX.world最新市场行情数据的API

接口	描述
http://api.hpx.world/data/v2/ticker	行情

返回值说明

High:最高价

Low：最低价

Buy：买-价

Sell：卖-价

Last：最新成交价

Vol：成交量（最近的24小时）

请求参数说明

参数名	描述
currency	h_cnyt:HCash/人民币代币
	btc_cnyt:比特币/人民币代币
	eos_eth:eos_eth
	leek_cnyt:韭菜币/人民币代币
	trx_cnyt:trx_cnyt

2、获取所有行情的API

接口	描述
http://api.hpx.world/data/v2/tickers	所有行情

返回值说明

high:最高价

low：最低价

buy：买-价

sell：卖-价

last：最新成交价

vol：成交量（最近的24小时）

3、获取市场深度的API

接口	描述
http://api.hpx.world/data/v2/depth	市场深度

返回值说明

asks：卖方深度

bids：买方深度

timestamp：此次深度产生的时间戳

请求参数说明

参数名	描述
currency	hc_cnyt:HCash/人民币代币
	btc_cnyt:比特币/人民币代币
	eos_eth:eos_eth
	leek_cnyt:韭菜币/人民币代币
	trx_cnyt:trx_cnyt
size	请求数量，默认3 非必传
merge	合并深度，默认0.1 非必传

4、获取历史成交记录的API

接口	描述
http://api.hpx.world/data/v2/trades	历史成交

返回值说明：

date：交易时间（时间戳）

price：交易价格

amount：交易数量

tid：交易序号

type：交易类型，0:买 /  1:卖

请求参数说明：

参数名	描述
currency	hc_cnyt:HCash/人民币代币
	btc_cnyt:比特币/人民币代币
	eos_eth:eos_eth
	leek_cnyt:韭菜币/人民币代币
	trx_cnyt:trx_cnyt
number	数量，默认50 非必传

5、获取K线图的API

接口	描述
http://api.hpx.world/data/v2/kline	K线

返回值说明：

data：K线说明

data：内容说明

[1417536000000：时间戳，2370.16：开，2380： 高，2352：低，2367.37： 收，17259.83：交易量]

请求参数说明：

参数名	描述
currency	hc_cnyt:HCash/人民币代币
	btc_cnyt:比特币/人民币代币
	eos_eth:eos_eth
	leek_cnyt:韭菜币/人民币代币
	trx_cnyt:trx_cnyt

6、获取全部交易对的API

接口	描述
http://api.hpx.world/data/v2/symbols	全部交易对

返回值说明：

code:0000表示成功

data：交易所支持的交易对

Symbol： 交易对代码

fPricePlace：显示小数位

id:交易对编号

7、查询交易所支持的交易对的API

接口	描述
http://api.hpx.world/data/v2/products	查询交易所支持的交易对

返回值说明：[{"marketName":"CNYT","fromSymbol":"HC","toSymbol":"CNYT","assetName":"HC","id":"HC_CNYT"},
{"marketName":"CNYT","fromSymbol":"BTC","toSymbol":"CNYT","assetName":"BTC","id":"BTC_CNYT"}]

参数说明：
marketName：交易区
fromSymbol：左边名称
toSymbol：右币名称
id：显示交易对

二、交易API

1、委托下单的API

接口	描述
http://api.hpx.world/api/v2/order	委托下单

返回值说明：

code：返回代码

message：提示信息

ID：委托挂单号

请求参数说明：

参数名	描述
method	直接赋值order
accesskey	accesskey
currency	btc_cnyt:比特币/人民币代币
tradeType	0：买， 1：卖
price	价格
amount	数量
sign	请求加密签名串
reqTime	当前时间毫秒数

2、获取买单或卖单的API

接口	描述
http://api.hpx.world/api/v2/getOrder	获取委托买单或卖单

返回值说明：

currency：交易对类型

id：委托挂单号

price：单价

status：挂单状态（1：待成交，2：待成交未交易部分，3：交易完成，5：已取消）

total_amount：挂单总数量

trade_amount：已成交数量

trade_date：委托时间

trade_money：已成交总金额

trade_price：成交均价

type：挂单类型0/1（buy/sell）

请求参数说明：

参数名	描述
method	直接赋值getorder
accesskey	accesskey
id	委托挂单号
currency	hc_cnyt:HCash/人民币代币
	btc_cnyt:比特币/人民币代币
	eos_eth:eos_eth
	leek_cnyt:韭菜币/人民币代币
	trx_cnyt:trx_cnyt
sign	请求加密签名串
reqTime	当前时间毫秒数

3、获取多个委托买单或卖单，每次请求返回pageSize<100条记录的API

接口	描述
http://api.hpx.world/api/v2/getOrders	获取多个委托买单或卖单，每次请求返回pageSize<100条记录

返回值说明：

currency：交易类型

id：委托挂单号

price：单价

status：挂单状态（1：待成交，2：待成交未交易部分，3：交易完成，5：已取消）

total_amount：挂单总数量

trade_amount：已成交数量

trade_date：委托时间

trade_money：已成交总金额

trade_price：成交均价

type：挂单类型0/1（buy/sell）

请求参数说明：

参数名	描述
method	直接赋值getOrders
accesskey	accesskey
typeTrade	交易类型0/1 [买/卖]
currency	hc_cnyt:HCash/人民币代币
	btc_cnyt:比特币/人民币代币
	eos_eth:eos_eth
	leek_cnyt:韭菜币/人民币代币
	trx_cnyt:trx_cnyt
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

4、查询你的历史交易记录的API

接口	描述
http://api.hpx.world/api/v2/getHistoryTrades	查询自己的历史交易数据

返回值描述：[{"amount":5.000000000000,“fstatus”:3,"price":45000.000000000000,"id":2567104,"type":"buy","timestamp":1542081470000}]

请求参数说明：
method：取值为getHistoryTrades
accesskey：用户申请的accesskey
pair：交易对名称
limit：分页大小

status:订单状态3已完全成交，5已撤单

5、单笔撤单

接口	描述
http://api.hpx.world/api/v2/cancel	撤销单笔订单

返回值说明：

code：返回代码

message：提示信息

请求参数说明：

参数名	描述
accesskey	accesskey
id	订单编号
currency	btc_cnyt:比特币/人民币代币

6、撤销所有单

接口	描述
http://api.hpx.world/api/v2/cancelAll	撤销所有订单

返回值说明：

code：返回代码

message：提示信息

请求参数说明：

参数名	描述
accesskey	accesskey
fexchangeid	交易对编号
type	类型，0买 1卖
minPrice	最低价格
maxPrice	最高价格

三、账户API

1、获取账户信息的API

接口	描述
http://api.hpx.world/api/v2/getAccountInfo	获取账户信息

返回值说明：

totalAsset：折合总资产（RMB）

balance（可用余额）：

frozen：冻结金额

lock：锁仓余额

请求参数说明

参数名	描述
accesskey	accesskey
sign	请求加密签名串
reqTime	当前时间毫秒数

2、获取用户充值地址的API

接口	描述
http://api.hpx.world/api/v2/getUserAddress	获取用户充值地址

返回值说明：

Key：地址

请求参数说明：

参数名	描述
accesskey	accesskey
currency	btc币种名
sign	请求加密签名串
reqTime	当前时间毫秒数

3、获取数字资产提现记录的API

接口	描述
http://api.hpx.world/api/v2/getWithdrawRecord	获取数字资产提现记录

返回值说明：

code：返回代码

message：提示信息

amount：提现金额

fees：提现手续费

id：提现记录ID

managetime：提现处理的时间的时间戳

submittime：提现发起的时间的时间戳

toAddress：提现的接收地址

请求参数说明：

参数名	描述
accesskey	accesskey
currency	btc币种名
pageindex	当前页数
pagesize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

4、获取数字资产充值记录的API

接口	描述
http://api.hpx.world/api/v2/getChargeRecord	获取数字资产充值记录

返回值说明：

code：代码

message：提示信息

amount：充值金额

confirmTimes：充值确认次数

currency：充值货币类型（大写）

description：充值记录状态描述

hash：交易记录号

id：充值记录id

status：状态（0等待确认，1充值失败，2充值成功）

submit_time：充值时间

address：充值地址

请求参数说明：

参数名	描述
accesskey	accesskey
currency	tst币种名
pageindex	当前页数
pagesize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

四、错误代码

所有API方法调用在请求失败或遇到未知错误时会返回JSON错误对象。

代码	描述
0000	调用成功
1000	系统异常
2000	非法访问
2001	accessKey不能为空
2002	accessKey非法
2011	timestamp格式不正确
2012	timestamp与服务器时间相差太多
2021	sign不能为空
2022	签名不一致
2023	签名失败
2031	业务参数不能为空
3000	用户状态异常
3001	钱包余额不足
3100	不支持的交易
3101	当前时间段停止交易
3102	交易价格不在合理范围内
3103	交易金额不在合理范围内
3104	委单失败
3105	撤销委单失败
3106	撤销所有委单失败
3107	获取委单信息失败
3108	不支持的币种
3109	超过每日提现次数
3110	超过每日提现最大数量
3111	需绑定手机或者邮箱
3112	需要实名认证
3113	账号异常被冻结，如有疑问请联系客服
3114	用户禁止提现，如有疑问请联系客服
3115	平仓中
3116	提现小于最小值
3117	需要设置交易密码
3118	交易密码错误超过当天最大次数
3119	交易密码错误
3120	用户余额不足
3121	提现地址未验证
3122	请求频率太高,请稍后
3123	无对应地址

五、示例代码

目前支持JAVA 版本。其他语言版本会相继支持。如果在使用过程中有任何问题请联系我们API技术QQ群： 361145004，我们将在第一时间帮您解决技术问题。

签名方式： 先用SHA加密secretkey，然后根据加密过的secretkey把请求的参数签名，请求参数按照上述接口参数列表排序加密，通过md5填充16位加密（HmacMD5）。

下面以下单接口为例（http://api.hpx.world/api/v2/order）：

public static void main(String[] args){
    HashMap<String, String> signMap = new LinkedHashMap<>();
    signMap.put("method","order");
    signMap.put("accesskey","ak661d032a6b9049c2");
    signMap.put("currency","btc_cnyt");
    signMap.put("tradeType","0");
    signMap.put("price","6");
    signMap.put("amount","1");
    signMap.remove("sign");
    signMap.remove("reqTime");
    String plainText = EncryptDigestUtil.getPlainSignString(signMap);
    String encryptSecretKey = EncryptDigestUtil.digest("f8076530d051421a9f5349e57363124e"); // 私钥
    String mySign = EncryptDigestUtil.sign(plainText, encryptSecretKey);
    System.out.println("Plain Text: " + plainText +  ", encryptSecretKey:" + encryptSecretKey + ", Signature Text: " + mySign);
  }



  拼接的字符串Plain Text（请求时间戳和签名不在加密字段内）: method=order&accesskey=ak661d032a6b9049c2¤cy=btc_cnyt&tradeType=0&price=6&amount=1



SHA加密后的secretkey： dea38fd8d53575a47451ad743e3973e64e4e7f1b



加密结果：f8f380ccd60b3a766b0172c37f71e172

六、常见问题

访问限制

单个用户限制每1秒只能请求一次数据。