ZB api
本文介绍ZB api
Rest API (已开启)
ZB为用户提供了一个简单的而又强大的API，旨在帮助用户快速高效的将ZB交易功能整合到自己应用当中。
如果在使用过程中有任何问题，请加群764113552，我们将为您做出最权威的解答。
配置API
获取ZB最新市场配置数据
| 接口 | 描述 |
|---|---|
http://api.zb.cn/data/v1/markets获取已开启的市场信息，包括价格、数量小数点位数
示例1
//# Request 2
GET http://api.zb.cn/data/v1/markets 3
//# Response 4
{
5
"btc_usdt": {
6
"amountScale": 4, 7
"priceScale": 2 8
}, 9
"ltc_usdt": {
10
"amountScale": 3, 11
"priceScale": 2 12
} 13
... 14
} 15
返回值说明1
priceScale : 价格小数位数 2
amountScale : 数量小数位数 3
|
|
行情API
获取ZB最新市场行情数据
| 接口 | 描述 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
http://api.zb.cn/data/v1/allTicker全币种行情
示例1
//# Request 2
GET http://api.zb.cn/data/v1/allTicker 3
//# Response 4
{
5
"hpybtc":{
6
"vol":"19800.6", 7
"last":"0.00000237", 8
"sell":"0.000002366", 9
"buy":"0.00000236", 10
"high":"0.0000026552", 11
"low":"0.00000229" 12
}, 13
"tvqc":{
14
"vol":"2201510.1", 15
...... 16
} 17
返回值说明1
high : 最高价 2
low : 最低价 3
buy : 买一价 4
sell : 卖一价 5
last : 最新成交价 6
vol : 成交量(最近的24小时) 7
|
|||||||||||
http://api.zb.cn/data/v1/ticker行情
示例1
//# Request 2
GET http://api.zb.cn/data/v1/ticker?market=btc_usdt 3
//# Response 4
{
5
"ticker": {
6
"vol": "40.463", 7
"last": "0.899999", 8
"sell": "0.5", 9
"buy": "0.225", 10
"high": "0.899999", 11
"low": "0.081" 12
}, 13
"date": "1507875747359" 14
} 15
返回值说明1
high : 最高价 2
low : 最低价 3
buy : 买一价 4
sell : 卖一价 5
last : 最新成交价 6
vol : 成交量(最近的24小时) 7
请求参数说明
|
|||||||||||
http://api.zb.cn/data/v1/depth市场深度
示例1
//# Request 2
GET http://api.zb.cn/data/v1/depth?market=btc_usdt&size=3 3
//# Response 4
{
5
"asks": [ 6
[ 7
83.28, 8
11.8 9
]... 10
], 11
"bids": [ 12
[ 13
81.91, 14
3.65 15
]... 16
], 17
"timestamp" : 时间戳 18
} 19
返回值说明1
asks : 卖方深度 2
bids : 买方深度 3
timestamp : 此次深度的产生时间戳 4
请求参数说明
|
|||||||||||
http://api.zb.cn/data/v1/trades历史成交
示例1
//# Request 2
GET http://api.zb.cn/data/v1/trades?market=btc_usdt 3
//# Response 4
[ 5
{
6
"amount": 0.541, 7
"date": 1472711925, 8
"price": 81.87, 9
"tid": 16497097, 10
"trade_type": "ask", 11
"type": "sell" 12
}... 13
] 14
返回值说明1
date : 交易时间(时间戳) 2
price : 交易价格 3
amount : 交易数量 4
tid : 交易生成ID 5
type : 交易类型，buy(买)/sell(卖) 6
trade_type : 委托类型，ask(卖)/bid(买) 7
请求参数说明
|
|||||||||||
http://api.zb.cn/data/v1/klineK线
示例1
//# Request 2
GET http://api.zb.cn/data/v1/kline?market=btc_usdt 3
//# Response 4
{
5
"data": [ 6
[ 7
1472107500000, 8
3840.46, 9
3843.56, 10
3839.58, 11
3843.3, 12
492.456 13
]... 14
], 15
"moneyType": "btc", 16
"symbol": "ltc" 17
} 18
返回值说明1
data : K线内容 2
moneyType : 买入货币 3
symbol : 卖出货币 4
data : 内容说明 5
[ 6
1417536000000, 时间戳 7
2370.16, 开 8
2380, 高 9
2352, 低 10
2367.37, 收 11
17259.83 交易量 12
] 13
请求参数说明
|
|||||||||||
交易API
用于ZB快速进行交易
| 接口 | 描述 | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
https://trade.zb.cn/api/order委托下单
示例1
//# Request 2
GET https://trade.zb.cn/api/order?accesskey=youraccesskey&amount=1.502 3
¤cy=qtum_usdt&method=order&price=1.9001&tradeType=1 4
&sign=请求加密签名串&reqTime=当前时间毫秒数 5
//# Response 6
{
7
"code": "1000", 8
"message": "操作成功", 9
"id": "20131228361867" 10
} 11
返回值说明1
code : 返回代码 2
message : 提示信息 3
id : 委托挂单号 4
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||||||
https://trade.zb.cn/api/cancelOrder取消委托
示例1
//# Request 2
GET https://trade.zb.cn/api/cancelOrder?accesskey=youraccesskey 3
¤cy=ltc_btc&id=201710111625&method=cancelOrder 4
&sign=请求加密签名串&reqTime=当前时间毫秒数 5
//# Response 6
{
7
"code": "1000", 8
"message": "操作成功" 9
} 10
返回值说明1
code : 返回代码 2
message : 提示信息 3
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||||||
https://trade.zb.cn/api/getOrder获取委托买单或卖单
示例1
//# Request 2
GET https://trade.zb.cn/api/getOrder?accesskey=youraccesskey 3
¤cy=ltc_btc&id=201710122805&method=getOrder 4
&sign=请求加密签名串&reqTime=当前时间毫秒数 5
//# Response 6
{
7
"currency": "btc", 8
"id": "20150928158614292", 9
"price": 1560, 10
"status": 3, 11
"total_amount": 0.1, 12
"trade_amount": 0, 13
"trade_date": 1443410396717, 14
"trade_money": 0, 15
"type": 0, 16
} 17
返回值说明1
currency : 交易类型 2
id : 委托挂单号 3
price : 单价 4
status : 挂单状态（1：取消，2：交易完成，0/3：待成交/待成交未交易部份） 5
total_amount : 挂单总数量 6
trade_amount : 已成交数量 7
trade_date : 委托时间 8
trade_money : 已成交总金额 9
type : 挂单类型 1/0[buy/sell] 10
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||||||
| https://trade.zb.cn/api/getOrders获取多个委托买单或卖单，每次请求返回10条记录 | |||||||||||||||||||||
| https://trade.zb.cn/api/getOrdersNew(新)获取多个委托买单或卖单，每次请求返回pageSize<100条记录 | |||||||||||||||||||||
| https://trade.zb.cn/api/getOrdersIgnoreTradeType与getOrdersNew的区别是取消tradeType字段过滤，可同时获取买单和卖单，每次请求返回pageSize10条记录 | |||||||||||||||||||||
| https://trade.zb.cn/api/getUnfinishedOrdersIgnoreTradeType获取未成交或部份成交的买单和卖单，每次请求返回pageSize<=10条记录 | |||||||||||||||||||||
https://trade.zb.cn/api/getAccountInfo获取用户信息
示例1
//# Request 2
GET https://trade.zb.cn/api/getAccountInfo?accesskey=youraccesskey&method=getAccountInfo 3
&sign=请求加密签名串&reqTime=当前时间毫秒数 4
//# Response 5
{
6
"result": {
7
"coins": [ 8
{
9
"enName": "ZB", 10
"freez": "0.00000000", 11
"fundstype": 51, 12
"unitDecimal": 8, 13
"cnName": "ZB", 14
"isCanRecharge": true, 15
"unitTag": "ZB", 16
"isCanWithdraw": true, 17
"available": "0.00361064", 18
"canLoan": false, 19
"key": "zb" 20
}, 21
... 22
], 23
"base": {
24
"username": "lianlianyi", 25
"trade_password_enabled": true, 26
"auth_google_enabled": true, 27
"auth_mobile_enabled": true 28
} 29
}, 30
"assetPerm": true, 31
"leverPerm": true, 32
"entrustPerm": true, 33
"moneyPerm": true 34
} 35
返回值说明1
auth_google_enabled : 是否开通谷歌验证 2
auth_mobile_enabled : 是否开通手机验证 3
trade_password_enabled : 是否开通交易密码 4
username : 用户名 5
coins: 6
key:币种 7
ename:币种英文名 8
cnName:币种中文名 9
showName:若有改名则为新币名称，否则同ename 10
unitTag:币种符号 11
available：可用资产 12
freez：冻结资产 13
unitDecimal：保留小数位 14
isCanRecharge:是否可充值 15
isCanWithdraw:是否可提现 16
canLoan:是否可理财 17
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||||||
| https://trade.zb.cn/api/getUserAddress获取用户充值地址 | |||||||||||||||||||||
| https://trade.zb.cn/api/getWithdrawAddress获取用户认证的提现地址 | |||||||||||||||||||||
| https://trade.zb.cn/api/getWithdrawRecord获取数字资产提现记录 | |||||||||||||||||||||
| https://trade.zb.cn/api/getChargeRecord获取数字资产充值记录 | |||||||||||||||||||||
| https://trade.zb.cn/api/withdraw提现 | |||||||||||||||||||||
杠杆API
用于杠杆借贷、理财
| 接口 | 描述 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| https://trade.zb.cn/api/getLeverAssetsInfo获取用户杠杆信息 | |||||||||||||||||
| https://trade.zb.cn/api/getLeverBills获取杠杆账单 | |||||||||||||||||
| https://trade.zb.cn/api/transferInLever资产转入杠杆区 | |||||||||||||||||
| https://trade.zb.cn/api/transferOutLever资产转出杠杆区 | |||||||||||||||||
| https://trade.zb.cn/api/loan发布理财 | |||||||||||||||||
| https://trade.zb.cn/api/cancelLoan取消理财 | |||||||||||||||||
| https://trade.zb.cn/api/getLoans获取可借贷列表 | |||||||||||||||||
| https://trade.zb.cn/api/getLoanRecords获取借贷记录 | |||||||||||||||||
| https://trade.zb.cn/api/borrow借款 | |||||||||||||||||
https://trade.zb.cn/api/repay还款
示例1
//# Request 2
GET https://trade.zb.cn/api/repay?accesskey=youraccesskey&loanRecordId=289&method=repay 3
&repayAmount=100&repayType=0 4
&sign=请求加密签名串&reqTime=当前时间毫秒数 5
//# Response 6
{
7
"code": "1000", 8
"message": "操作成功" 9
} 10
返回值说明1
code : 返回代码 2
message : 提示信息 3
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||
https://trade.zb.cn/api/getRepayments获取还款记录
示例1
//# Request 2
GET https://trade.zb.cn/api/getRepayments?accesskey=youraccesskey&loanRecordId=50 3
&method=getRepayments&pageIndex=1&pageSize=10 4
&sign=请求加密签名串&reqTime=当前时间毫秒数 5
//# Response 6
{
7
"code" : 1000, 8
"message" : "操作成功", 9
"result" : [ 10
{
11
"benJin" : "29", 12
"id" : 42, 13
"statusShow" : "已还", 14
"status" : 1, 15
"liXi" : "0.0145", 16
"actureDate" : 1522031604000 17
} 18
] 19
} 20
返回值说明1
code : 返回代码 2
message : 提示信息 3
result : 4
id : 还款记录ID 5
benJin : 本金 6
liXi : 利息 7
status : 状态 8
statusShow : 状态值对应中文 9
actureDate : 实际还款日期 10
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||
https://trade.zb.cn/api/getFinanceRecords获取理财记录
示例1
//# Request 2
GET https://trade.zb.cn/api/getFinanceRecords?accesskey=youraccesskey&coin=qc&method=getFinanceRecords 3
&pageIndex=1&pageSize=10&sign=请求加密签名串&reqTime=当前时间毫秒数 4
//# Response 5
{
6
"code" : 1000, 7
"message" : "操作成功", 8
"result" : [ 9
{
10
"id" : 156, 11
"userId" : 110803, 12
"userName" : "13427002684", 13
"fundType" : 15, 14
"coinName" : "QC", 15
"amount" : "10", 16
"hasAmount" : "0", 17
"status" : 0, 18
"statusShow" : "未有借入", 19
"createTime" : 1524541195000, 20
"interestRateOfDay" : "0.0012", 21
"repaymentDay" : 10, 22
"isLoop" : true, 23
"inTimes" : 0, 24
"sourceType" : 6 25
}, 26
... 27
] 28
} 29
返回值说明1
code : 返回代码 2
message : 提示信息 3
result : 4
id : 理财ID 5
userId : 用户ID 6
userName : 用户名 7
fundType : 币种类型 8
coinName : 币种名称 9
amount : 理财金额 10
hasAmount : 已借出金额 11
status : 状态值 12
statusShow : 状态值对应中文 13
createTime : 发布时间 14
interestRateOfDay : 日利率 15
repaymentDay : 放贷天数 16
isLoop : 是否自动放贷 17
inTimes : 理财被借入次数 18
sourceType : 来源类型8”网页”，5”手机APP”，6”接口API” 19
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||
https://trade.zb.cn/api/changeInvestMark变更是否自动续借
示例1
//# Request 2
GET https://trade.zb.cn/api/changeInvestMark?accesskey=youraccesskey&investMark=1&loanRecordId=借贷id&method=changeInvestMark 3
&sign=请求加密签名串&reqTime=当前时间毫秒数 4
//# Response 5
{
6
"code" : 1000, 7
"message" : "操作成功", 8
} 9
返回值说明1
code : 返回代码 2
message : 提示信息 3
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||
https://trade.zb.cn/api/changeLoop变更是否自动放贷
示例1
//# Request 2
GET https://trade.zb.cn/api/changeLoop?accesskey=youraccesskey&isLoop=1&loanId=放贷id&method=changeLoop 3
&sign=请求加密签名串&reqTime=当前时间毫秒数 4
//# Response 5
{
6
"code" : 1000, 7
"message" : "操作成功", 8
} 9
返回值说明1
code : 返回代码 2
message : 提示信息 3
请求参数说明(签名参数按照ASCII值排序,Sign和ReqTime不用加入待签名字符串)
|
|||||||||||||||||
子账号API
用于子账号管理
| 接口 | 描述 |
|---|---|
| https://trade.zb.cn/api/addSubUser创建子账号 | |
| https://trade.zb.cn/api/getSubUserList获取子账号列表 | |
| https://trade.zb.cn/api/doTransferFunds主子账号内部转账 | |
| https://trade.zb.cn/api/createSubUserKey创建子账号API | |
错误代码
所有API方法调用在请求失败或遇到未知错误时会返回JSON错误对象。
| 代码 | 描述 |
|---|---|
| 1000 | 调用成功 |
| 1001 | 一般错误提示 |
| 1002 | 内部错误 |
| 1003 | 验证不通过 |
| 1004 | 资金安全密码锁定 |
| 1005 | 资金安全密码错误，请确认后重新输入。 |
| 1006 | 实名认证等待审核或审核不通过 |
| 1009 | 此接口维护中 |
| 1010 | 暂不开放 |
| 1012 | 权限不足 |
| 1013 | 不能交易，若有疑问请联系在线客服 |
| 1014 | 预售期间不能卖出 |
| 2002 | 比特币账户余额不足 |
| 2003 | 莱特币账户余额不足 |
| 2005 | 以太币账户余额不足 |
| 2006 | ETC币账户余额不足 |
| 2007 | BTS币账户余额不足 |
| 2009 | 账户余额不足 |
| 3001 | 挂单没有找到 |
| 3002 | 无效的金额 |
| 3003 | 无效的数量 |
| 3004 | 用户不存在 |
| 3005 | 无效的参数 |
| 3006 | 无效的IP或与绑定的IP不一致 |
| 3007 | 请求时间已失效 |
| 3008 | 交易记录没有找到 |
| 4001 | API接口被锁定 |
| 4002 | 请求过于频繁 |
示例代码
目前支持C#、C++、HTML、JAVA、Python 版本。其他语言版本会相继支持。如果在使用过程中有任何问题请联系我们API技术QQ群： 764113552，我们将在第一时间帮您解决技术问题。
签名方式： 先用sha加密secretkey，然后根据加密过的secretkey把请求的参数签名，请求参数按照ASCII值排序加密，通过hmac MD5加密
//......
//SECRETKEY加密前:48939bbc-8d49-402b-b731-adadf2ea9628
//SECRETKEY加密后:6186ec9223b8f8e3fe28b5f5c831427ed99950a6
//参数排序后(按字母顺序):accesskey=6d8f62fd-3086-46e3-a0ba-c66a929c24e2&method=getAccountInfo
//加密后得到的sign:fa5d8d4e37caa86551b9ac740df2b14c
String ACCESS_KEY = "your_access_key";
String SECRET_KEY = "your_secret_key";
params.put("accesskey", ACCESS_KEY);// 这个需要加入签名,放前面
String digest = EncryDigestUtil.digest(SECRET_KEY);
// 参数按照ASCII值排序
// (首先比较参数名的第一个字母，按abcdefg顺序排列，若遇到相同首字母，则看第二个字母，以此类推)
String sign = EncryDigestUtil.hmacSign(MapSort.toStringMap(params), digest);
String method = params.get("method");
// 加入验证
params.put("sign", sign);
params.put("reqTime", System.currentTimeMillis() + "");
String url = "请求地址:" + URL_PREFIX + method + " 参数:" + params;
String json = "";
try {
json = HttpUtilManager.getInstance().requestHttpPost(URL_PREFIX, method, params);
} catch (HttpException | IOException e) {
log.error("获取交易json异常", e);
}
//......
ZB api的更多相关文章
- WebApi系列~基于RESTful标准的Web Api
微软的web api是在vs2012上的mvc4项目绑定发行的,它提出的web api是完全基于RESTful标准的,完全不同于之前的(同是SOAP协议的)wcf和webService,它是简单,代码 ...
- WebApi系列~实际项目中如何使用HttpClient向web api发异步Get和Post请求并且参数于具体实体类型
回到目录 本讲比较实际,在WEB端有一个Index和Create方法,用来从web api显示实体列表数据和向api插入实体对象,这就是以往的网站,只不过是把数据持久化过程放到了web pai上面,它 ...
- 基于RESTful标准的Web Api
微软的web api是在vs2012上的mvc4项目绑定发行的,它提出的web api是完全基于RESTful标准的,完全不同于之前的(同是SOAP协议的)wcf和webService,它是简单,代码 ...
- libvirt 基于C API基本使用案例
玩开源分享,需要有干到底的精神,今晚随便逛逛技术论坛突发有感;Ruiy不足之处,需跟进了; 最近变的较懒了,干活有点没劲,也不怪干来干去收获不大,缺少鼓励! 现在玩的技术大多是上不了台面了,想过没,你 ...
- 安卓---高德地图API应用
说明:定位需要导入android_location 的jar包,如果没有会报错,这个官方网站好像找不到,这是我在网上找到的一个链接 http://download.csdn.net/detail/ra ...
- zabbix常用的python类api
zabbix自带api #!/usr/bin/python #coding:utf-8 import requests import json url = "http://192.168.9 ...
- 各大知名区块链交易所链接及API文档链接
区块链交易所链接 火币网(Huobi):https://www.huobi.br.com/zh-cn/ API文档:https://github.com/huobiapi/API_Docs/wiki ...
- Web API 入门 一
因为只是是一个简单的入门.所有暂时不去研究web API一些规范.比如RESTful API 这里有个接收RESTful API的.RESTful API 什么是WebApi 看这里:http://w ...
- 循序渐进学.Net Core Web Api开发系列【16】：应用安全续-加密与解密
系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 应用安全除 ...
随机推荐
- MinGW 是什么
3.1:MinGW 是什么? MinGW 提供了一套简单方便的Windows下的基于GCC 程序开发环境.MinGW 收集了一系列免费的Windows 使用的头文件和库文件:同时整合了GNU ( ht ...
- apt-get/dpkg常用指令备查
apt-get install <package> Downloads <package> and all of its dependencies, and installs ...
- django初体验 学习笔记
django环境搭建 1.安装Python 2.ipython sudo apt-get install ipython sudo pip instal ...
- 原创：Eclipse安装Eclipse Color Themes插件后，编辑器背景颜色被改变
如题,卸载Eclipse Color Themes插件后,背景颜色还是白色,蛋疼,修改.metadata\.plugins\org.eclipse.core.runtime\.settings中的or ...
- JS 实现拖动效果
<html> <body style="margin:0px;"> <script src="http://ajax.googleapis. ...
- .net 取得类的属性、方法、成员及通过属性名取得属性值
//自定义的类 model m = new model(); //取得类的Type实例 //Type t = typeof(model); //取得m的Type实例 Type t = m.GetTyp ...
- WP8.1学习系列(第二十章)——添加控件和处理事件
先决条件 添加控件 设置控件的名称 设置控件属性 创建事件处理程序 新控件 总结 相关主题 通过使用如按钮.文本框和组合框等控件,你可以创建应用的 UI. 下面将显示如何将控件添加到应用.处理控件时, ...
- 五、K3 WISE 开发插件《K3 Wise 群发短信配置开发（二）之短信群发配置》
开发环境:K/3 Wise 13.0.Sql Server 2005 目录 一.开启Sql Server Agent代理服务 二.短信发送原理 三.编写存储过程 四.开启Sql Server作业 一. ...
- 【Eclipse】启动时报错：No Java virtual machine （已解决）
在 Ubuntu 上下了个最新的 Eclipse ,解压后运行报这样的错误: 当然 JDK 的安装及环境变量的配置是没有问题的.使用 java -version 查询本机的JDK版本是可以的. 如果不 ...
- Express+Less+Gulp配置高效率开发环境
版权声明:本文由金朝麟原创文章,转载请注明出处: 文章原文链接:https://www.qcloud.com/community/article/627049001486519548 来源:腾云阁 h ...