第三章 tushare数据接口包的认识

首先整个turshare数据可大概分为7个大类。
####交易类数据
提供股票的交易行情数据，通过简单的接口调用可获取相应的DataFrame格式数据，主要包括以下类别：

历史行情数据
复权历史数据
实时行情数据
历史分笔数据
实时报价数据
当日历史分笔
大盘指数列表
大单交易数据
####投资参考数据
投资参考提供一些可能会影响股票价格走势的信息数据，为投资者在做投资决策时提供数据参考，亦可作为量化策略模型的事件因子纳入模型的计算。TuShare提供的参考数据主要包括以下：

分配预案
业绩预告
限售股解禁
基金持股
新股上市
融资融券（沪市）
融资融券（深市）
####股票分类数据
类数据提供股票的分类信息数据，从股票类型的不同角度进行数据分类，在一些统计套利方法的应用中，时常会以股票的分类来做切入，比如对某些行业或概念进行阶段统计来决定近期的交易策略等。TuShare提供的分类数据主要包括以下类别：

行业分类
概念分类
地域分类
中小板分类
创业板分类
风险警示板分类
沪深300成份股及权重
上证50成份股
中证500成份股
终止上市股票列表
暂停上市股票列表
####基本面数据
基本面类数据提供所有股票的基本面情况，包括股本情况、业绩预告和业绩报告等。主要包括以下类别：

沪深股票列表
业绩预告
业绩报告（主表）
盈利能力数据
营运能力数据
成长能力数据
偿债能力数据
现金流量数据
本模块数据全部来自sina财经，由于财务数据项目比较多，所以拆分成了几个表，使用时可以通过股票代码合并在一起，也可以独立使用。数据在获取时，需要一页一页的抓取，所以需要一点等待时间，最后会合并成一个大表。
####宏观经济数据
宏观经济数据提供国内重要的宏观经济数据，目前只提供比较常用的宏观经济数据，通过简单的接口调用可获取相应的DataFrame格式数据，大项主要包括以下类别：

金融信息数据
国民经济数据
价格指数数据
景气指数数据
对外经济贸易数据
####新闻事件数据
新闻事件接口主要提供国内财经、证券、港股和期货方面的滚动新闻，以及个股的信息地雷数据。目前主要包括以下类别：

即时财经新闻
个股信息地雷
新浪股吧新闻
####龙虎榜数据
龙虎榜数据接口提供历史龙虎榜上榜股票数据，主要包括以下类别：

每日龙虎榜列表
个股上榜统计
营业部上榜统计
龙虎榜机构席位追踪
龙虎榜机构席位成交明细
####上海银行间同业拆放利率
Shibor接口是获取上海银行间同业拆放利率（Shanghai Interbank Offered Rate，简称Shibor）的便捷接口，以年为参数获取，可以取到公布的Shibor品种包括隔夜、1周、2周、1个月、3个月、6个月、9个月及1年的周期数据。目前主要包括以下类别：

Shibor拆放利率
银行报价数据
Shibor均值数据
贷款基础利率（LPR）
LPR均值数据

---

对我来说，最重要就是交易类数据。
#####①历史行情数据：
官方通知在新版0.5.6中，已经新增了一个接口：get_k_data，建议使用全新接口，老接口逐步被放进history。
新接口融合了get_hist_data和get_h_data两个老接口的功能，即能方便获取历史日周月的低频数据，也可以获取5、15、30和60分钟相对高频的数据。
新接口不足的地方是，目前暂时还没有成交额数据。另外，几类平均线数据也没有提供，而在写这个接口的时候，也由于时间有限，还没有把平均线数据加进来。所以跟老接口比起来，少了以上两类数据。

新接口如果不设定开始和结束日期，则返回近一年数据。
从性能上考虑，推荐设定开始日期和结束日期，而且最好不要超过三年以上，获取全部历史数据，请分年段分步获取，取到数据后，请及时在本地存储。
get_k_data(code,ktype=D,autype=qfq,index=False,start=‘’1年前‘’,end=current)
老接口get_hist_data获取单只股票或指数的数据（三年），需要全部历史数据，请调用下一个接口get_h_data()。

ts.get_hist_data('600848', ktype='W') #获取周k线数据
ts.get_hist_data('600848', ktype='M') #获取月k线数据
ts.get_hist_data('600848', ktype='5') #获取5分钟k线数据
ts.get_hist_data('600848', ktype='15') #获取15分钟k线数据
ts.get_hist_data('600848', ktype='30') #获取30分钟k线数据
ts.get_hist_data('600848', ktype='60') #获取60分钟k线数据
ts.get_hist_data('sh'）#获取上证指数k线数据，其它参数与个股一致，下同
ts.get_hist_data('sz'）#获取深圳成指k线数据
ts.get_hist_data('hs300'）#获取沪深300指数k线数据
ts.get_hist_data('sz50'）#获取上证50指数k线数据
ts.get_hist_data('zxb'）#获取中小板指数k线数据
ts.get_hist_data('cyb'）#获取创业板指数k线数据

#####②复权历史数据
见上，新接口已经包括了该功能。

#####③实时行情数据
一次性获取当前交易所有股票的行情数据（如果是节假日，即为上一交易日，结果显示速度取决于网速）

import tushare as ts
ts.get_today_all()

返回值说明：

code：代码
name:名称
changepercent:涨跌幅
trade:现价
open:开盘价
high:最高价
low:最低价
settlement:昨日收盘价
volume:成交量
turnoverratio:换手率
amount:成交量
per:市盈率
pb:市净率
mktcap:总市值
nmc:流通市值
#####④实时分笔数据
获取实时分笔数据，可以实时取得股票当前报价和成交信息，其中一种场景是，写一个python定时程序来调用本接口（可两三秒执行一次，性能与行情软件基本一致），然后通过DataFrame的矩阵计算实现交易监控，可实时监测交易量和价格的变化。
参数说明：symbols：6位数字股票代码，或者指数代码，可输入的类型：str、list、set或者pandas的Series对象

import tushare as ts

df = ts.get_realtime_quotes('000581')

返回值说明：

0：name，股票名字
1：open，今日开盘价
2：pre_close，昨日收盘价
3：price，当前价格
4：high，今日最高价
5：low，今日最低价
6：bid，竞买价，即“买一”报价
7：ask，竞卖价，即“卖一”报价
8：volume，成交量 maybe you need do volume/100
9：amount，成交金额（元 CNY）
10：b1_v，委买一（笔数 bid volume）
11：b1_p，委买一（价格 bid price）
12：b2_v，“买二”
13：b2_p，“买二”
14：b3_v，“买三”
15：b3_p，“买三”
16：b4_v，“买四”
17：b4_p，“买四”
18：b5_v，“买五”
19：b5_p，“买五”
20：a1_v，委卖一（笔数 ask volume）
21：a1_p，委卖一（价格 ask price）
…
30：date，日期；
31：time，时间；
请求多个股票方法（一次最好不要超过30个）：

#symbols from a list
ts.get_realtime_quotes(['600848','000980','000981'])
#from a Series
ts.get_realtime_quotes(df['code'].tail(10))  #一次获取10个股票的实时分笔数据

#####⑤当日历史分笔
获取当前交易日（交易进行中使用）已经产生的分笔明细数据。

import tushare as ts

df = ts.get_today_ticks('601333')

######⑥实时大盘指数行情
获取所有大盘指数实时行情列表，以表格的形式展示。

import tushare as ts

df = ts.get_index()

返回值说明：

code:指数代码
name:指数名称
change:涨跌幅
open:开盘点位
preclose:昨日收盘点位
close:收盘点位
high:最高点位
low:最低点位
volume:成交量(手)
amount:成交金额（亿元）