股票查询接口

本系列目录：-文摘-
1. 新浪的股票查询接口：讲解了该接口的数据结构；
2. 新浪的股票查询接口（使用篇）：用一个简单的例子演示该接口的使用;
3. 实时股票信息查询：一个高级的例子，能够自动刷新股票信息，实现了实时更新；

以大秦铁路（股票代码：601006）为例，如果要获取它的最新行情，只需访问新浪的股票数据接口：http://hq.sinajs.cn/list=sh601006
这个url会返回一串文本，例如：

var hq_str_sh601006=“大 秦铁路, 27.55, 27.25, 26.91, 27.55, 26.20, 26.91, 26.92, 22114263, 589824680, 4695, 26.91, 57590, 26.90, 14700, 26.89, 14300, 26.88, 15100, 26.87, 3100, 26.92, 8900, 26.93, 14230, 26.94, 25150, 26.95, 15220, 26.96, 2008-01-11, 15:05:32“;

这个接口对于JavaScript程序非常方便，通常的使用方式为，静态或动态地在页面中插入：

<script type=“text/javascript“ src=“http://hq.sinajs.cn/list=sh601006“ charset=“gb2312“></script>

这样一来，你就可以在JS中用变量名“hq_str_sh601006”访问大秦铁路的行情数据了。下一篇文章用JavaScript代码演示了具体使用方法。

这个字符串由许多数据拼接在一起，不同含义的数据用逗号隔开了，按照程序员的思路，顺序号从0开始。
0：”大秦铁路”，股票名字；
1：”27.55″，今日开盘价；
2：”27.25″，昨日收盘价；
3：”26.91″，当前价格；
4：”27.55″，今日最高价；
5：”26.20″，今日最低价；
6：”26.91″，竞买价，即“买一”报价；
7：”26.92″，竞卖价，即“卖一”报价；
8：”22114263″，成交的股票数，由于股票交易以一百股为基本单位，所以在使用时，通常把该值除以一百；
9：”589824680″，成交金额，单位为“元”，为了一目了然，通常以“万元”为成交金额的单位，所以通常把该值除以一万；
10：”4695″，“买一”申请4695股，即47手；
11：”26.91″，“买一”报价；
12：”57590″，“买二”
13：”26.90″，“买二”
14：”14700″，“买三”
15：”26.89″，“买三”
16：”14300″，“买四”
17：”26.88″，“买四”
18：”15100″，“买五”
19：”26.87″，“买五”
20：”3100″，“卖一”申报3100股，即31手；
21：”26.92″，“卖一”报价
(22, 23), (24, 25), (26,27), (28, 29)分别为“卖二”至“卖四的情况”
30：”2008-01-11″，日期；
31：”15:05:32″，时间；

如果你要同时查询多个股票，那么在URL最后加上一个逗号，再加上股票代码就可以了；比如你要一次查询大秦铁路（601006）和大同煤业（601001）的行情，就这样使用URL：

http://hq.sinajs.cn/list=sh601003,sh601001

返回的数据为：

1. var hq_str_sh601003=“柳 钢股份, 18.91, 18.80, 18.81, 19.10, 18.51, 18.80, 18.81, 5125000, 96017794, 9115, 18.80, 5100, 18.79, 12000, 18.78, 1800, 18.77, 2600, 18.76, 1500, 18.81, 25283, 18.82, 4470, 18.84, 3400, 18.85, 1600, 18.86, 2008-01-11, 15:05:32“;
2. var hq_str_sh601001=“大 同煤业, 40.00, 40.06, 39.81, 40.60, 39.13, 39.82, 39.83, 8117292, 324759633, 50, 39.82, 300, 39.81, 22809, 39.80, 1500, 39.79, 2600, 39.78, 600, 39.83, 10600, 39.85, 2100, 39.87, 2390, 39.88, 1000, 39.89, 2008-01-11, 15:05:32“;

但如果你要查询大盘指数，情况会有不同，比如查询上证综合指数（000001），使用如下URL：

http://hq.sinajs.cn/list=s_sh000001

返回的数据为：

var hq_str_s_sh000001=“上证指数,5484.677,28.136,0.52,877247,15587495“;

数据含义分别为：指数名称，当前点数，当前价格，涨跌率，成交量（手），成交额（万元）；

查询深圳成指的URL为：

http://hq.sinajs.cn/list=s_sz399001

数据构成方式与上证综合指数的数据相同。

在上一篇日志中，我介绍了新浪个股的查询接口和数据结构，现在用具体的代码演示如何使用这个接口。

还是以查询大秦铁路为例，在页面中插入这样的代码：

1. <scripttype=“text/javascript“src=“http://hq.sinajs.cn/list=sh601006“charset=“gb2312“></script>
2. <script type=“text/javascript“>
3.     var elements=hq_str_sh601006.split(“,”);
4.     document.write(“current price:”+elements[3]);
5. </script>

这段代码输出大秦铁路（股票代码：601006）的当前股价。下面是代码的运行结果（请确认你的浏览器允许运行JavaScript，另外，RSS订阅者请到Web页面上来看）：

current price:7.44current price:25.00
大家可以和新浪的结果对比，应该是同样的值。当然，这段代码不会自动刷新股票价格。
(update：我已经发布了能够实时更新数据的代码：链接)

还是以大秦铁路为例，为了体现实时性，这段代码显示当前股价（由于不同浏览器动态载入script的方法略有不同，这段代码只适用于IE和firefox浏览器）：

1. <inputtype=“text“id=“realtimeprice“></input>
2. <script type=“text/javascript“src=“http://hq.sinajs.cn/list=sh601006“id=“jscode“charset=“gb2312“></script>
3. <script type=“text/javascript“>
4.     function reload(){
5.         var code=document.getElementById(“jscode”);
6.         if(!code) return;
7.         document.body.removeChild(code);
8.         code=document.createElement(“script”);
9.         code.src=”http://hq.sinajs.cn/list=sh601006″;
10.         code.id=”jscode”;
11.         code.charset=”gb2312″;
12.         document.body.appendChild(code);
13.         elements=hq_str_sh601006.split(“,”);
14.         document.getElementById(“realtimeprice”).value=elements[3];           
15.     }
16.     reload();
17.     setInterval(reload,2000);//每两秒钟更新一次   
18. </script>

请大家把这段代码复制下来，插入到一个新建html文档的body标签之间。由于本网站其他脚本和这段代码有些冲突，而且该代码只适用于IE和firefox浏览器，所以我就不在这里显示运行结果了。

不过我上传了一个样本，大家可以点击这个链接看到效果（只限IE和Firefox）：链接
（另外，请大家稍有耐心，只有原始数据出现变化的时候，我的代码才能显示出变化，对不对？而且我的代码是每隔两秒钟获取一次数据。当你发现数据不再变化的时候，应该是交易所已经结束当天交易了，等第二天吧 ）

大家可以自行对照新浪的网页看显示的是否正确：链接