开发者-CHBTC兑换中心-比特币交易-比特币价格-以太坊价格-以太坊交易-莱特币交易-数字资产-用心服务每一刻

Rest API

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

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

行情API

获取CHBTC最新市场行情数据

接口

描述

http://api.chbtc.com/data/v1/ticker 行情

http://api.chbtc.com/data/v1/depth 市场深度

http://api.chbtc.com/data/v1/trades 历史成交

http://api.chbtc.com/data/v1/kline K线

交易API

用于CHBTC快速进行交易

接口

描述

https://trade.chbtc.com/api/order 委托下单

https://trade.chbtc.com/api/cancelOrder 取消委托

https://trade.chbtc.com/api/getOrder 获取委托买单或卖单

示例

//# Request
GET https://trade.chbtc.com/api/getOrder?method=getOrder
	&accesskey=your_access_key&id=123456789&currency=btc_cny
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "currency": "btc",
    "fees": 0,
    "id": "20150928158614292",
    "price": 1560,
    "status": 3,
    "total_amount": 0.1,
    "trade_amount": 0,
    "trade_price" : 6000,
    "trade_date": 1443410396717,
    "trade_money": 0,
    "type": 0,
    "fees": 0
}

返回值说明

currency : 交易类型（目前仅支持btc_cny/ltc_cny/eth_cny/eth_btc/etc_cny）
id : 委托挂单号
price : 单价
status : 挂单状态(0：待成交,1：取消,2：交易完成,3：待成交未交易部份)
total_amount : 挂单总数量
trade_amount : 已成交数量
trade_date : Unix时间戳
trade_money : 已成交总金额
trade_price : 成交均价
type : 挂单类型 1/0[buy/sell]
fees : 交易手续费,卖单的话,显示的是收入货币(如人民币);买单的话,显示的是买入货币(如etc)

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getOrder
accesskey	accesskey
id	委托挂单号
currency	btc_cny :比特币/人民币 ltc_cny :莱特币/人民币 eth_cny :以太币/人民币 eth_btc :以太币/比特币 etc_cny :ETC币/人民币 bts_cny :BTS币/人民币
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getOrders 获取多个委托买单或卖单，每次请求返回10条记录

示例

//# Request
GET https://trade.chbtc.com/api/getOrders?method=getOrders
	&accesskey=your_access_key&tradeType=1&currency=btc_cny&pageIndex=1
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
[
    {
        "currency": "btc",
        "id": "20150928158614292",
        "price": 1560,
        "status": 3,
        "total_amount": 0.1,
        "trade_amount": 0,
    	"trade_price" : 6000,
        "trade_date": 1443410396717,
        "trade_money": 0,
        "type": 0,
        "fees": 0
    }...
]

返回值说明

currency : 交易类型（目前仅支持btc_cny/ltc_cny/eth_cny/eth_btc/etc_cny）
id : 委托挂单号
price : 单价
status : 挂单状态(0：待成交,1：取消,2：交易完成,3：待成交未交易部份)
total_amount : 挂单总数量
trade_amount : 已成交数量
trade_date : Unix时间戳
trade_money : 已成交总金额
trade_price : 成交均价
type : 挂单类型 1/0[buy/sell]
fees : 交易手续费,卖单的话,显示的是收入货币(如人民币);买单的话,显示的是买入货币(如etc)

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getOrders
accesskey	accesskey
tradeType	交易类型1/0[buy/sell]
currency	btc_cny :比特币/人民币 ltc_cny :莱特币/人民币 eth_cny :以太币/人民币 eth_btc :以太币/比特币 etc_cny :ETC币/人民币 bts_cny :BTS币/人民币
pageIndex	当前页数
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getOrdersNew (新)获取多个委托买单或卖单，每次请求返回pageSize<100条记录

示例

//# Request
GET https://trade.chbtc.com/api/getOrdersNew?method=getOrdersNew
	&accesskey=your_access_key&tradeType=1&currency=btc_cny&pageIndex=1
	&pageSize=20&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
[
    {
        "currency": "btc",
        "id": "20150928158614292",
        "price": 1560,
        "status": 3,
        "total_amount": 0.1,
        "trade_amount": 0,
    	"trade_price" : 6000,
        "trade_date": 1443410396717,
        "trade_money": 0,
        "type": 0,
        "fees": 0
    }...
]

返回值说明

currency : 交易类型（目前仅支持btc_cny/ltc_cny/eth_cny/eth_btc/etc_cny）
id : 委托挂单号
price : 单价
status : 挂单状态(0：待成交,1：取消,2：交易完成,3：待成交未交易部份)
total_amount : 挂单总数量
trade_amount : 已成交数量
trade_date : Unix时间戳
trade_money : 已成交总金额
trade_price : 成交均价
type : 挂单类型 1/0[buy/sell]
fees : 交易手续费,卖单的话,显示的是收入货币(如人民币);买单的话,显示的是买入货币(如etc)

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getOrdersNew
accesskey	accesskey
tradeType	交易类型1/0[buy/sell]
currency	btc_cny :比特币/人民币 ltc_cny :莱特币/人民币 eth_cny :以太币/人民币 eth_btc :以太币/比特币 etc_cny :ETC币/人民币 bts_cny :BTS币/人民币
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getOrdersIgnoreTradeType 与getOrdersNew的区别是取消tradeType字段过滤，可同时获取买单和卖单，每次请求返回pageSize<100条记录

示例

//# Request
GET https://trade.chbtc.com/api/getOrdersIgnoreTradeType?method=getOrdersIgnoreTradeType
	&accesskey=your_access_key&tradeType=1&currency=btc_cny&pageIndex=1
	&pageSize=20&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
[
    {
        "currency": "btc",
        "id": "20150928158614292",
        "price": 1560,
        "status": 3,
        "total_amount": 0.1,
        "trade_amount": 0,
    	"trade_price" : 6000,
        "trade_date": 1443410396717,
        "trade_money": 0,
        "type": 0,
        "fees": 0
    }...
]

返回值说明

currency : 交易类型（目前仅支持btc_cny/ltc_cny/eth_cny/eth_btc/etc_cny）
id : 委托挂单号
price : 单价
status : 挂单状态(0：待成交,1：取消,2：交易完成,3：待成交未交易部份)
total_amount : 挂单总数量
trade_amount : 已成交数量
trade_date : Unix时间戳
trade_money : 已成交总金额
trade_price : 成交均价
type : 挂单类型 1/0[buy/sell]
fees : 交易手续费,卖单的话,显示的是收入货币(如人民币);买单的话,显示的是买入货币(如etc)

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getOrdersIgnoreTradeType
accesskey	accesskey
tradeType	交易类型1/0[buy/sell]
currency	btc_cny :比特币/人民币 ltc_cny :莱特币/人民币 eth_cny :以太币/人民币 eth_btc :以太币/比特币 etc_cny :ETC币/人民币 bts_cny :BTS币/人民币
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getUnfinishedOrdersIgnoreTradeType 获取未成交或部份成交的买单和卖单，每次请求返回pageSize<=100条记录

示例

//# Request
GET https://trade.chbtc.com/api/getUnfinishedOrdersIgnoreTradeType?method=getUnfinishedOrdersIgnoreTradeType
	&accesskey=your_access_key&currency=btc_cny&pageIndex=1&pageSize=20
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
[
    {
        "currency": "btc",
        "id": "20150928158614292",
        "price": 1560,
        "status": 3,
        "total_amount": 0.1,
        "trade_amount": 0,
    	"trade_price" : 6000,
        "trade_date": 1443410396717,
        "trade_money": 0,
        "type": 0,
        "fees": 0
    }...
]

返回值说明

currency : 交易类型（目前仅支持btc_cny/ltc_cny/eth_cny/eth_btc/etc_cny）
id : 委托挂单号
price : 单价
status : 挂单状态(0：待成交,1：取消,2：交易完成,3：待成交未交易部份)
total_amount : 挂单总数量
trade_amount : 已成交数量
trade_date : Unix时间戳
trade_money : 已成交总金额
trade_price : 成交均价
type : 挂单类型 1/0[buy/sell]
fees : 交易手续费,卖单的话,显示的是收入货币(如人民币);买单的话,显示的是买入货币(如etc)

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值order
accesskey	accesskey
currency	btc_cny :比特币/人民币 ltc_cny :莱特币/人民币 eth_cny :以太币/人民币 eth_btc :以太币/比特币 etc_cny :ETC币/人民币 bts_cny :BTS币/人民币
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getAccountInfo 获取用户信息

示例

//# Request
GET https://trade.chbtc.com/api/getAccountInfo?method=getAccountInfo
	&accesskey=your_access_key&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "result": {
        "base": {
            "auth_google_enabled": true,
            "auth_mobile_enabled": true,
            "trade_password_enabled": true,
            "username": "xxxxxx"
        },
        "totalAssets" : 123.551,
        "netAssets" : 332.31,
        "balance": {
            "CNY": {
                "amount": 471.88165,
                "currency": "CNY",
                "symbol": "%EF%BF%A5"
            },
            "BTC": {
                "amount": 0.00015285,
                "currency": "BTC",
                "symbol": "%E0%B8%BF"
            },
            "LTC": {
                "amount": 0.98076355,
                "currency": "LTC",
                "symbol": "%C5%81"
            },
            "ETH": {
                "amount": 0,
                "currency": "ETH",
                "symbol": "E"
            },
            "DAO": {
                "amount": 0,
                "currency": "DAO",
                "symbol": "D"
            },
            "ETC": {
                "amount": 0.0965,
                "currency": "ETC",
                "symbol": "e"
            },
            "BTS": {
                "amount": 0.09,
                "currency": "BTS",
                "symbol": "BTS"
            }
        },
        "frozen": {
            "CNY": {
                "amount": 0,
                "currency": "CNY",
                "symbol": "%EF%BF%A5"
            },
            "BTC": {
                "amount": 0.00012731,
                "currency": "BTC",
                "symbol": "%E0%B8%BF"
            },
            "LTC": {
                "amount": 0,
                "currency": "LTC",
                "symbol": "%C5%81"
            },
            "ETH": {
                "amount": 0,
                "currency": "ETH",
                "symbol": "E"
            },
            "DAO": {
                "amount": 0,
                "currency": "DAO",
                "symbol": "D"
            },
            "ETC": {
                "amount": 0,
                "currency": "ETC",
                "symbol": "e"
            },
            "BTS": {
                "amount": 0.09,
                "currency": "BTS",
                "symbol": "BTS"
            }
        },
        "p2p": {
            "inCNY": 0,
            "inBTC": 0,
            "inLTC": 0,
            "inETH": 0,
            "inDAO": 0,
            "inETC": 0,
            "outCNY": 0,
            "outBTC": 0,
            "outLTC": 0,
            "outETH": 0,
            "outDAO": 0,
            "outETC": 0
        }
    },
    "limit": 20
}

返回值说明

auth_google_enabled : 是否开通谷歌验证
auth_mobile_enabled : 是否开通手机验证
trade_password_enabled : 是否开通交易密码
username : 用户名
totalAssets : 折合总资产(RMB)
netAssets : 净资产(RMB)
balance(余额):
    CNY(人民币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    BTC(比特币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    LTC(莱特币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    ETH(以太币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    ETC(ETC币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    BTS(BTS币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
frozen(冻结):
    CNY(人民币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    BTC(比特币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    LTC(莱特币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    ETH(以太币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    ETC(ETC币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
    BTS(BTS币详情) :
        amount : 余额
        currency : 币种
        symbol : 货币符号（encodeURI编码）
p2p:
    inCNY : 已借入人民币 
    inBTC : 已借入比特币
    inLTC : 已借入莱特币
    inETH : 已借入以太币
    inETC : 已借入ETC币
    outCNY : 已借出人民币
    outBTC : 已借出比特币
    outLTC : 已借出莱特币
    outETH : 已借出以太币
    outETC : 已借出ETC币

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getAccountInfo
accesskey	accesskey
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getUserAddress 获取用户充值地址

https://trade.chbtc.com/api/getWithdrawAddress 获取用户认证的提现地址

https://trade.chbtc.com/api/getWithdrawRecord 获取数字资产提现记录

示例

//# Request
GET https://trade.chbtc.com/api/getWithdrawRecord?method=getWithdrawRecord
	&accesskey=your_access_key&currency=btc&pageIndex=1&pageSize=10
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "code": 1000,
    "message": {
        "des": "success",
        "isSuc": true,
        "datas": {
            "list": [
                {
                    "amount": 0.01,
                    "fees": 0.001,
                    "id": 2016042556231,
                    "manageTime": 1461579340000,
                    "status": 3,
                    "submitTime": 1461579288000,
                    "toAddress": "14fxEPirL9fyfw1i9EF439Pq6gQ5xijUmp"
                }...
            ],
            "pageIndex": 1,
            "pageSize": 10,
            "totalCount": 4,
            "totalPage": 1
        }
    }
}

返回值说明

code : 返回代码
message : 提示信息
amount : 提现金额
fees : 提现手续费
id : 提现记录id
manageTime : 提现处理的时间的时间戳
submitTime : 提现发起的时间的时间戳
toAddress : 提现的接收地址

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getWithdrawRecord
accesskey	accesskey
currency	btc :BTC ltc :LTC eth :以太币 etc :ETC币
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getChargeRecord 获取数字资产充值记录

示例

//# Request
GET https://trade.chbtc.com/api/getChargeRecord?method=getChargeRecord
	&accesskey=your_access_key&currency=btc&pageIndex=1&pageSize=10
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "code": 1000,
    "message": {
        "des": "success",
        "isSuc": true,
        "datas": {
            "list": [
                {
                    "address": "1FKN1DZqCm8HaTujDioRL2Aezdh7Qj7xxx",
                    "amount": "1.00000000",
                    "confirmTimes": 1,
                    "currency": "BTC",
                    "description": "确认成功",
                    "hash": "7ce842de187c379abafadd64a5fe66c5c61c8a21fb04edff9532234a1dae6xxx",
                    "id": 558,
                    "itransfer": 1,
                    "status": 2,
                    "submit_time": "2016-12-07 18:51:57"
                }...
            ],
            "pageIndex": 1,
            "pageSize": 10,
            "total": 8
        }
    }
}

返回值说明

code : 返回代码
message : 提示信息
amount : 充值金额
confirmTimes : 充值确认次数
currency : 充值货币类型(大写)
description : 充值记录状态描述
hash : 充值交易号
id : 充值记录id
itransfer : 是否内部转账，1是0否
status : 状态(0等待确认，1充值失败，2充值成功)
submit_time : 充值时间
address : 充值地址

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getChargeRecord
accesskey	accesskey
currency	btc :BTC ltc :LTC eth :以太币 etc :ETC币
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getCnyWithdrawRecord 获取人民币提现记录

示例

//# Request
GET https://trade.chbtc.com/api/getCnyWithdrawRecord?method=getCnyWithdrawRecord
	&accesskey=your_access_key&pageIndex=1&pageSize=10
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "code": 1000,
    "message": {
        "des": "success",
        "isSuc": true,
        "datas": {
            "list": [
                {
                    "account": "****4523",
                    "amount": 1000,
                    "bank": "中国邮政银行",
                    "date": 1473155402000,
                    "description": "预计09月07日24点前到账<p class=\"auditico2\"></p>",
                    "fee": 5,
                    "serial_number": 2016090686300,
                    "status": 3,
                    "type": "易宝支付"
                }...
            ],
            "pageIndex": 1,
            "pageSize": 10,
            "total": 20
        }
    }
}

返回值说明

code : 返回代码
message : 提示信息
account : 收款账号(只显示后4位)
amount : 提现金额
date : 提现时间，格式为时间戳
description : 提现记录状态描述
fees : 提现手续费
serial_number : 提现记录id
status : 提现记录状态(10等待实名认证，6等待确认，4提现成功，14提现中，3提现中，5提现失败)
type : 提现类型

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getCnyWithdrawRecord
accesskey	accesskey
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/getCnyChargeRecord 获取人民币充值记录

示例

//# Request
GET https://trade.chbtc.com/api/getCnyChargeRecord?method=getCnyChargeRecord
	&accesskey=your_access_key&pageIndex=1&pageSize=10
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "code": 1000,
    "message": {
        "des": "success",
        "isSuc": true,
        "datas": {
            "list": [
                {
                    "account": "6212867603158157",
                    "amount": 1234,
                    "date": 1460102487000,
                    "description": "成功<p class=\"auditico3\"></p>",
                    "serial_number": 20160408241,
                    "status": 0,
                    "type": "线下银行汇款"
                }...
            ],
            "pageIndex": 1,
            "pageSize": 10,
            "total": 32
        }
    }
}

返回值说明

code : 返回代码
message : 提示信息
account : 充值账号
amount : 充值金额
date : 充值时间
description : 充值状态描述
serial_number : 充值记录id
status : 充值状态(9等待处理，1充值失败，0充值成功，13充值已过期，8已取消，2处理中，10等待实名认证)
type : 充值类型

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
method	直接赋值getChargeRecord
accesskey	accesskey
pageIndex	当前页数
pageSize	每页数量
sign	请求加密签名串
reqTime	当前时间毫秒数

https://trade.chbtc.com/api/withdraw 提现

示例

//# Request
GET https://trade.chbtc.com/api/withdraw?accesskey=your_access_key
	&amount=0.01&currency=btc&fees=0.001&itransfer=0&method=withdraw
	&receiveAddr=14fxEPirL9fyfw1i9EF439Pq6gQ5xijUmp&safePwd=资金安全密码
	&sign=请求加密签名串&reqTime=当前时间毫秒数
//# Response
{
    "code": 1000,
    "message": "success",
    "id": "提现记录id"
}

返回值说明

code : 返回代码
message : 提示信息
id : 提现记录id

请求参数说明(加密签名请根据这个顺序签名,sign和reqTime不用加入待签名字符串)

参数名	描述
accesskey	accesskey
amount	提现金额
currency	btc :BTC ltc :LTC eth :以太币 etc :ETC币
fees	提现矿工费比特币最低是0.0003 莱特币最低是0.001 以太币最低是0.01 ETC最低是0.01
itransfer	是否同意bitbank系内部转账(0不同意，1同意，默认不同意)
method	直接赋值withdraw
receiveAddr	接收地址（必须是认证了的地址，bts的话，以"账户_备注"这样的格式）
safePwd	资金安全密码
sign	请求加密签名串
reqTime	当前时间毫秒数

错误代码

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

代码	描述
1000	调用成功
1001	一般错误提示
1002	内部错误
1003	验证不通过
1004	资金安全密码锁定
1005	资金安全密码错误，请确认后重新输入。
1006	实名认证等待审核或审核不通过
1009	此接口维护中
2001	人民币账户余额不足
2002	比特币账户余额不足
2003	莱特币账户余额不足
2005	以太币账户余额不足
2006	ETC币账户余额不足
2007	BTS币账户余额不足
3001	挂单没有找到
3002	无效的金额
3003	无效的数量
3004	用户不存在
3005	无效的参数
3006	无效的IP或与绑定的IP不一致
3007	请求时间已失效
3008	交易记录没有找到
4001	API接口被锁定或未启用
4002	请求过于频繁

示例代码

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

//......
try{
	//......
	String accesskey = "your_access_key";
	String secretkey = "your_secret_key";
	String baseURL = "https://trade.chbtc.com/api/order";
	String params = "method=order&accesskey="+accesskey+"&price=4024.52&amount=1.52&tradeType=1&currency=btc";
	String secret = EncryDigestUtil.digest(secretkey);
	String sign = EncryDigestUtil.hmacSign(params, secret);
	String url = baseURL + "?" + params + "&sign=" + sign + "&reqTime=" + System. currentTimeMillis();
	String result = doRequest(url);
	//......
}catch(Exception ex){
	ex.printStackTrace();
}
//......

文档下载

下载DEMO以及开发文档

立即下载>>

常见问题

访问限制

1.单个IP限制每分钟1000次访问，超过1000次将被锁定1小时，一小时后自动解锁。

2.单个用户限制每秒钟10次访问，一秒钟内10次以上的请求，将会视作无效。

3.K线接口每秒只能请求一次数据。