现货 RESTful 市场数据API

注意：如果您对我们的实时市场交易数据更感兴趣，请参考我们最新版的websocket API和FIX API文档:

市场数据API是公开使用的, 无需进行身份验证。对于每个API，您可以提供您要查询的市场。默认为 “btccny”, 这是 BTC／CNY 的市场。需要 LTC／CNY，请使用 “market=ltccny”, 即 “https://data.btcchina.com/data/ticker?market=ltccny”. 需要 LTC／BTC，请使用 “market=ltcbtc”。请注意，过频访问可能导致IP拦截。

市场数据 API v1.3.3

2014-11-21 市场数据API v1.3.3: 增加了Q&A部分.

市场数据 API v1.3.2

2014-09-11 市场数据API v1.3.2: 为行情API增加了一个新的返回值”open”,增加了FIX API文档链接.

市场数据 API v1.3.1

2014-08-21 市场数据API v1.3.1: 为行情API增加了两个新的返回值”vwap”和”prev_close”。

市场数据 API v1.3

2014-08-15 市场数据API v1.3为买卖订单API增加了“limit”参数。

市场数据 API v1.2

2014-07-31 市场数据API v1.2为交易历史API增加了“sincetype”参数。

#3市场数据 API v1.1 2014-07-09 市场数据API v1.1为交易历史API增加了limit参数.

市场数据 API v1

市场数据API v1提供了行情，交易，交易历史，买卖订单四种查询方法。

行情

获取最新的行情数据。使用参数 market 来指明单个市场或所有市场。

# 单个市场 ##
{
	"ticker": {
	"high": "2894.97",
	"low": "2850.08",
	"buy": "2876.92",
	"sell": "2883.80",
	"last": "2875.66",
	"vol": "4133.63800000",
	"date": 1396412995,
	"vwap": 2879.12,
	"prev_close": 2875.61,
	"open": 2880.01
  }
}	 
## 所有市场 ##
{
	"ticker_btccny": {
	"high": "2894.97",
	"low": "2850.08",
	"buy": "2880.00",
	"sell": "2883.86",
	"last": "2880.00",
	"vol": "4164.41040000",
	"date": 1396412841,
	"vwap": 2879.12,
	"prev_close": 2875.61,
	"open": 2880.01
  },
	"ticker_ltccny": {
	"high": "78.80",
	"low": "77.50",
	"buy": "78.22",
	"sell": "78.35",
	"last": "78.35",
	"vol": "56443.71000000",
	"date": 1396412841,
	"vwap": 78.12,
	"prev_close": 78.61,
	"open": 78.62
  },
	"ticker_ltcbtc": {
	"high": "0.02800000",
	"low": "0.02710000",
	"buy": "0.02720000",
	"sell": "0.02730000",
	"last": "0.02720000",
	"vol": "7715.69400000",
	"date": 1396412841,
	"vwap": 0.0274,
	"prev_close": 0.0273,
	"open": 0.0272
  }
}

参数名	类型	描述
high	string	近24小时内最高价格
low	string	近24小时内最低价格
buy	string	最高出价
sell	string	最低要价
last	string	最新成交价格
vol	string	近24小时内比特币成交量
date	number	最新更新时间
vwap	number	近24小时内平均成交价
prev_close	number	昨日收盘价
open	number	今日开盘价

交易

获取过去24小时内的交易历史,注意,为了保证服务质量和响应速度,返回的交易数量上限为10000个。

https://data.btcchina.com/data/trades

[{
	"date":"1383286640",
	"price":1264.31,
	"amount":0.01,
	"tid":"680350"
},{
	"date":"1383286877",
	"price":1264.33,
	"amount":1,
	"tid":"680351"
},{
	"date":"1383286880",
	"price":1264.79,
	"amount":0.3,
	"tid":"680352"
}]

参数名	类型	描述
date	string	Unix的时间（秒）自1970年1月1日
price	string	1个比特币的价格
amount	string	成交的比特币总量
tid	string	交易单号

交易历史

获取交易历史的清单，可通过设置since后的参数来获取较早的历史记录，可通过设置limit后的参数来获取指定数量的历史纪录，limit的默认值是100，有效区间是[0,5000]. 可通过设置sincetype参数为“id”或者“time”来指定since后的参数作用在哪个数据上，默认sincetype为id。

https://data.btcchina.com/data/historydata //return last 100 trade records.
https://data.btcchina.com/data/historydata?limit=10 //return last 10 trade records.
https://data.btcchina.com/data/historydata?since=5000 //return 100 trade records starting from id 5000.
https://data.btcchina.com/data/historydata?since=5000&limit=10 //return 10 trade records starting from id 5000.
https://data.btcchina.com/data/historydata?since=1406794449&limit=10&sincetype=time //return 10 trade records starting from unix time 1406794449.

[{
	"date":"1383374245",
	"price":1278.7,
	"amount":0.4,
	"tid":"684284",
	"type":"sell"
	},{
	"date":"1383374245",
	"price":1278.77,
	"amount":0.35,
	"tid":"684285",
	"type":"buy"
}]

参数名	类型	描述
date	string	Unix的时间（秒）自1970年1月1日
price	string	1个比特币的价格
amount	string	成交的比特币总量
tid	string	交易单号
type	string	表示交易为“买”或者“卖”

买卖订单

订单数据默认包含所有公开的要价和出价。可通过设置limit后的参数来获取指定数量的订单数据。

https://data.btcchina.com/data/orderbook//返回BTCCNY市场所有订单.
https://data.btcchina.com/data/orderbook?limit=10 //返回BTCCNY市场各10个买卖订单，其中买单是价格最高的十个，卖单为价格最低的十个，返回值均按照价格降序排序.
https://data.btcchina.com/data/orderbook?market=ltccny&limit=10 //返回LTCCNY市场各10个买卖订单，其中买单是价格最高的十个，卖单为价格最低的十个，返回值均按照价格降序排序.

{
	"asks":[
	[1279.1,3.036],
	[1278.8,7.9],
	[1278.77,8.9],
	[1278.7,2],
	[1278.68,0.359]
],
	"bids":[
	[1278.5,1.056],
	[1277.61,1.833],
	[1277.6,7.7],
	[1277.3,3],
	[1277.28,9.99],
],
	"date": 1395989337
}