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 一.概述 应用安全除 ...
随机推荐
- RF实现多次失败重跑结果合并的基础方法和优化方法
实现思路:通过分次执行失败案例重跑,然后通过结果文件合并命令实现多次失败重跑结果文件的合并,并输出合并后的log和report文件: 说明:具体失败案例重跑命令和结果文件合并命令请参考本博客其他相关章 ...
- Django SimpleCMDB WSGI
一.WSGI 介绍 (1) 在前面的学习中,我们是通过 python manage.py runserver 0.0.0.0:8000 来启动并访问开发服务器的:(2) 但在实际中我们是通过直接访问 ...
- C#编写中使用预编译指令代替不停的注释
是不是经常调试某个模块的时候,要打开一堆Console或者Debug.Log,printf 不调试的时候,又关掉.如此繁复的倒腾实在是烦 可以使用预编译指令代替这种做法 #define 自定义字段 . ...
- MQTT_DEMO
1 /* 2 Copyright (c) 2009-2012 Roger Light <roger@atchoo.org> 3 All rights reserved. 4 5 Redis ...
- Android学习之适配器ArrayAdapter SimpleAdapter
Adapter是个什么角色呢?其实它的作用就是View界面和数据之间的桥梁.我们可以看作是界面数据绑定的一种理解,它所操纵的数据一般都是一些比较复杂的数据,如数组,链表,数据库,集合等. 常用的适配器 ...
- 虚拟机可以ping同宿主机,宿主机ping不通虚拟机
虚拟机里能ping同本机,而本机却ping不通虚拟机,或者虚拟机不能ping通本机,可能有如下原因: 如果是桥接模式,那么可能性1:虚拟机防火墙禁ping,请关闭虚拟机防火墙重试:root 状态下se ...
- laravel blade模板里调用路由方法重定向
@if (Session::get('user') == NULL) {!!Redirect::to('login')!!} @endif or @if (Session::get('user') = ...
- vue 项目里正确地引用 jquery
一.NPM安装的jQuery 使用vue-cli构建的vue项目,需要修改的是build/webpack.base.conf.js 1.添加引入webpack,后面的plugins那里需要 const ...
- [NHibernate] Guid 作主键速度超慢的背后
http://blog.csdn.net/educast/article/details/6602353 最近遇到了一个让人抓狂的性能问题.生产环境里有一张表的数据量目前达到了 70 万条.结果发现无 ...
- Linux渗透之反弹Shell
前言 当我们在渗透Linux主机时,反弹一个交互的shell是非常有必要的.在搜索引擎上搜索关键字“Linux 反弹shell”,会出现一大堆相关文章,但是其内容不但雷同,而且都仅仅是告诉我们执行这个 ...