比特时代 API 使用说明 / Referance of BTC38.com's API
2014-07-10 10:49:44   浏览量:   关键词:使用说明 行情 时代
更新日期:2016年4月20日
Updated: Apr/20th/2016
 
交易行情API / Trades API
 
返回系统支持的所有交易对的最高,最低 交易行情和交易量,每15秒钟更新。
Return the highest, lowest  trade and the vulome of trade pairs. Refreshed every 15 seconds.
 
所有币种交易API /  All Pairs
 
单个币种交易API / Single Pair
 
 
市场深度API / Depth API
 
返回当前市场深度(委托挂单),其中 asks 是委卖单, bids 是委买单。返回30条。
Return the trade depth (current orders). Asks for buyer's order and bids for seller's order. 30 items each.
 
 
 
 
历史成交API / History API
 
返回系统支持的历史成交记录,返回最新30条。
Return the trade history. 30 items for each call.
 
 
 
 
返回从[TID](交易数自递增id)往后的最多500条历史成交记录(以比特币对人民币和比特股对比特币为例)
Return 500 items from the TID (BTC_CNY and BTS_BTC for example).
 

获取账户余额 Get Account Balance
 
调用方式 / Method:POST
传入参数 / Value:
key,时代提供的32位公钥 / public key
time,挂单时的时间戳,单位为秒 / the timestamp or the order, measured by "second"
md5,使用md5(key_用户ID_skey_time),SKEY为32位密钥,顺序不可颠倒 / the result of md5(key_userID_skey_time), SKEY is the secret key
 
返回:
JSON格式的余额,含所有币种

挂单 Make an Orders
 
http://api.btc38.com/v1/submitOrder.php(若挂单后未立即成交,则会额外返回挂单ID)
调用方式 / Method:POST
传入参数 / Value:
key,时代提供的32位公钥 / public key
time,挂单时的时间戳,单位为秒 / the timestamp or the order, measured by "second"
md5,使用md5(key_用户ID_skey_time),SKEY为32位密钥,顺序不可颠倒 / the result of md5(key_userID_skey_time), SKEY is the secret key
type,1为买入挂单,2为卖出挂单,不可为空 / the type of the order
mk_type,cny为人民币定价,btc为比特币定价,不可为空 / which market, BTC or CNY
price,价格,cny定价最多5位小数,btc定价最多8位小数,不同币种有所不同,以网站显示为准 / the price of  the order. decimal digits varies as per coins, you can get the decimal digits on our website
amount,数量,最多6位小数 / the amount of the order. 6 decimal digits at most
coinname,币名,比如BTC、DOGE、BTS / the Symbol of the coin. Ex: BTC, DOGE, BTS
 
返回 / Return:
succ,挂单成功 / successful (submitOrder.php)
succ|123,挂单成功,123为您挂单的ID / successful, 123 is your order_id
overBalance,账户余额不足 / insuffient balance
其它返回表示不同的错误,情况太多,暂不罗列,这种错误发生的可能性不大

 
撤单 Cancel an Order
 
调用方式 / Method:POST
传入参数 / Value:
key,时代提供的32位公钥 / public key
time,挂单时的时间戳,单位为秒 / the timestamp or the order, measured by "second"
md5,使用md5(key_用户ID_skey_time),SKEY为32位密钥,顺序不可颠倒 / the result of md5(key_userID_skey_time), SKEY is the secret key
mk_type,cny为人民币定价,btc为比特币定价,不可为空 / which market, BTC or CNY
order_id,要撤的单的ID the ID of the order you'd cancel
coinname,币名,比如BTC、DOGE、BTS / the Symbol of the coin. Ex: BTC, DOGE, BTS
 
返回:
succ,撤单成功 / successful 
overtime,该单不存在,或者已成交了 / order expired or traded
 

获取当前自己的挂单 Get Open Orders

http://api.btc38.com/v1/getOrderList.php
调用方式 / Method:POST
传入参数 / Value:
key,时代提供的32位公钥 / public key
time,挂单时的时间戳,单位为秒 / the timestamp or the order, measured by "second"
md5,使用md5(key_用户ID_skey_time),SKEY为32位密钥,顺序不可颠倒 / the result of md5(key_userID_skey_time), SKEY is the secret key
mk_type,cny为人民币定价,btc为比特币定价,不可为空 / which market, BTC or CNY
coinname,币名,比如BTC、LTC,不填则返回全部币种的挂单 / the coin's name. Eg. BTC、LTC. For default it will return order of all coins.
 
返回:
如果挂单为空,返回 [] / If there is no ordre, it will return []
如果挂单不为空,则返回比如 / if there is any order:
[{"order_id":"123", "order_type":"1", "order_coinname":"BTC", "order_amount":"23.232323", "order_price":"0.2929"}, {"order_id":"123", "order_type":"1", "order_coinname":"LTC","order_amount":"23.232323", "order_price":"0.2929"}]

获取自己的成交记录 Get My Trade List
调用方式 / Method:POST
传入参数 / Value:
key,时代提供的32位公钥 / public key
time,挂单时的时间戳,单位为秒 / the timestamp or the order, measured by "second"
md5,使用md5(key_用户ID_skey_time),SKEY为32位密钥,顺序不可颠倒 / the result of md5(key_userID_skey_time), SKEY is the secret key
mk_type,cny为人民币定价,btc为比特币定价,不可为空 / which market, BTC or CNY
coinname,币名,比如BTC、LTC / the coin's name. Eg. BTC、LTC. 
page,翻页,0为第1页,每页30条,不填则默认为第1页 / page number from 0. default is 0. (30 records per page)
 
返回:
为空则返回[]
不为空则返回用户的成交记录JSON,比如
{id:123,buyer_id:123,seller_id:123,volume:123,price:123,coinname:"btc",time:"1990-02-22 12:12:12"}

 
行情类API无须授权即可使用,交易类API需要公钥和密钥,如果您需要使用自动交易API,请点此获取
Public Key and Secret Key are demanded to use the trade API. If you need it, pelase click here.
 
由于我们的分布式CDN对非浏览器请求做了限制,因此调用API时,您可能需要人为设置USER-AGENT,以免被防火墙拦截。 调用API有技术方面的故障,请联系加 API 技术QQ 2805792922。
As the CDN has a technical strategy that limtes non-HTTP calling, you may need to config the header request of USER-AGENT, so as to avoid the request being filtered. For technical help, please contact contact#mail.btc38.com(# -> @).

因服务器有防CC攻击策略,每60秒内调用次数不可超过120次,超过部分将被防火墙拦截。
we have a technical strategy that limtes the frequency of  calling (no more than 120 times every 60 seconds ).

 附件:调用范例 / Demo (PHP)

 
$date = new DateTime();
$stamp = $date->getTimestamp();
 
$mdt = "这里写公钥_这里写用户ID_这里写私钥_" . $stamp;
$mdt = md5($mdt);
 
$data = array("key" => "这里写公钥", "time" => $stamp, "md5" => $mdt, "type" => 1, "mk_type" => "cny",
"price" => "0.0001", "amount" => "100", "coinname" => "XRP");
//$data_string = json_encode($data);
$ch = curl_init ();
curl_setopt ( $ch, CURLOPT_URL, 'http://www.btc38.com/trade/t_api/submitOrder.php' );
curl_setopt ( $ch, CURLOPT_POST, 1 );
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/4.0 (compatible; btc38 PHP bot; ' . php_uname('a') . '; PHP/' . phpversion() . ')');
 
$result = curl_exec($ch);
print_r($result);
?>
 



声明:部分文章转自互联网,如该转载不符合您的意愿或侵犯您的版权,请您与我们联系,我们会尽快删除。
投稿:如果您有需要发表的资讯文章,请发送至 contact@mail.btc38.com
分享到:
    
相关文章阅读:
频道热门文章:
比特时代 API 使用说明 / Referance of BTC38.com's API
更新日期:2016年4月20日Updated: Apr 20th 2016交易行情API Trades API返回系...
本月热门文章:
比特时代 API 使用说明 / Referance of BTC38.com's API
更新日期:2016年4月20日Updated: Apr 20th 2016交易行情API Trades API返回系...
上一篇
第一页
下一篇
最后一页
粤网文[2012]0884-143号 | 粤ICP备12061242号-2 | 工商注册号440301106023830 | [ICP证]粤B2-20120185 | 北京市大成(深圳)律师事务所 周菲 律师
CopyRight © 2013 比特时代 All Rights Reserved. Powered by 深圳智维网络有限公司
关于我们 | 官方微博 | 手机交易 | 用户协议 | 交易行情API | 约稿投稿 | English Version | +86-4000-523838