HPX.AI为用户提供了一个简单的而又强大的API,旨在帮助用户快速高效的将hpx.ai交易功能整合到自己应用当中。
如果在使用过程中有任何问题,请联系我们技术讨论QQ群:361145004,我们将为您做出最权威的解答。
一、行情API
1、获取HPX.ai最新市场行情数据的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
接口 |
描述 |
所有行情 |
返回值说明
high:最高价
low:最低价
buy:买-价
sell:卖-价
last:最新成交价
vol:成交量(最近的24小时)
3、获取市场深度的API
接口 |
描述 |
市场深度 |
返回值说明
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
接口 |
描述 |
历史成交 |
返回值说明:
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
接口 |
描述 |
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
接口 |
描述 |
全部交易对 |
返回值说明:
code:0000表示成功
data:交易所支持的交易对
Symbol: 交易对代码
fPricePlace:显示小数位
id:交易对编号
7、查询交易所支持的交易对的API
接口 |
描述 |
查询交易所支持的交易对 |
返回值说明:[{"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
接口 |
描述 |
委托下单 |
返回值说明:
code:返回代码
message:提示信息
ID:委托挂单号
请求参数说明:
参数名 |
描述 |
method |
直接赋值order
|
accesskey |
accesskey |
currency |
btc_cnyt:比特币/人民币代币 |
tradeType
|
0:买, 1:卖 |
price |
价格 |
amount
|
数量 |
sign |
请求加密签名串 |
reqTime |
当前时间毫秒数 |
2、获取买单或卖单的API
接口 |
描述 |
获取委托买单或卖单 |
返回值说明:
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
接口 |
描述 |
获取多个委托买单或卖单,每次请求返回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
接口 |
描述 |
查询自己的历史交易数据 |
返回值描述:[{"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
接口 |
描述 |
获取账户信息 |
返回值说明:
totalAsset:折合总资产(RMB)
balance(可用余额):
frozen:冻结金额
lock:锁仓余额
请求参数说明
参数名 |
描述 |
accesskey |
accesskey |
sign |
请求加密签名串 |
reqTime |
当前时间毫秒数 |
2、获取用户充值地址的API
接口 |
描述 |
获取用户充值地址 |
返回值说明:
Key:地址
请求参数说明:
参数名 |
描述 |
accesskey |
accesskey |
currency |
btc币种名 |
sign |
请求加密签名串 |
reqTime |
当前时间毫秒数 |
3、获取数字资产提现记录的API
接口 |
描述 |
获取数字资产提现记录 |
返回值说明:
code:返回代码
message:提示信息
amount:提现金额
fees:提现手续费
id:提现记录ID
managetime:提现处理的时间的时间戳
submittime:提现发起的时间的时间戳
toAddress:提现的接收地址
请求参数说明:
参数名 |
描述 |
accesskey |
accesskey |
currency |
btc币种名 |
pageindex |
当前页数 |
pagesize |
每页数量 |
sign |
请求加密签名串 |
reqTime |
当前时间毫秒数 |
4、获取数字资产充值记录的API
接口 |
描述 |
获取数字资产充值记录 |
返回值说明:
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秒只能请求一次数据。
评论
0 条评论
文章评论已关闭。