Tushare Pro 新版发布，数据更稳定质量更好，欢迎注册使用。
¶投资参考提供一些可能会影响股票价格走势的信息数据，为投资者在做投资决策时提供数据参考，亦可作为量化策略模型的事件因子纳入模型的计算。TuShare提供的参考数据主要包括以下：
- 分配预案
- 业绩预告
- 限售股解禁
- 基金持股
- 新股上市
- 融资融券（沪市）
- 融资融券（深市）
分配预案¶
每到季报、年报公布的时段，就经常会有上市公司利润分配预案发布，而一些高送转高分红的股票往往会成为市场炒作的热点。及时获取和统计高送转预案的股票是参与热点炒作的关键，TuShare提供了简洁的接口，能返回股票的送转和分红预案情况。
参数说明：
- year : 预案公布的年份，默认为2014
- top :取最新n条数据，默认取最近公布的25条
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- code:股票代码
- name:股票名称
- year:分配年份
- report_date:公布日期
- divi:分红金额（每10股）
- shares:转增和送股数（每10股）
调用方法：
import tushare as ts
df = ts.profit_data(top=60)
df.sort('shares',ascending=False)
结果显示：
code name year report_date divi shares
59 002555 顺荣三七 2014 2015-03-31 1.0 17
32 002269 美邦服饰 2014 2015-04-01 1.0 15
24 600353 旭光股份 2014 2015-04-02 0.7 10
27 002610 爱康科技 2014 2015-04-01 0.0 10
51 300287 飞利信 2014 2015-03-31 0.7 10
29 300168 万达信息 2014 2015-04-01 1.0 10
25 002681 奋达科技 2014 2015-04-01 1.5 8
31 300098 高新兴 2014 2015-04-01 0.5 6
44 300354 东华测试 2014 2015-03-31 0.3 6
8 300108 双龙股份 2014 2015-04-02 0.0 5
10 002396 星网锐捷 2014 2015-04-02 1.0 5
7 002686 亿利达 2014 2015-04-02 0.8 5
40 600735 新华锦 2014 2015-04-01 0.0 5
选择每10股送转在10以上的：
print df[df.shares>=10]
业绩预告¶
按年度、季度获取业绩预告数据，接口提供从1998年以后每年的业绩预告数据，需指定年度、季度两个参数。数据在获取的过程中，会打印进度信息(下同)。
参数说明：
- year:int 年度 e.g:2014
- quarter:int 季度 :1、2、3、4，只能输入这4个季度
结果返回的数据属性说明如下：
code,代码
name,名称
type,业绩变动类型【预增、预亏等】
report_date,发布日期
pre_eps,上年同期每股收益
range,业绩变动范围
调用方法：
#获取2014年中报的业绩预告数据
ts.forecast_data(2014,2)
结果返回：
code name type report_date pre_eps range
0 000710 天兴仪表 预亏 2014-08-27 -0.0178 --
1 600710 常林股份 减亏 2014-08-23 -0.12 --
2 002071 长城影视 预升 2014-08-21 0.0032 6.72
3 000555 神州信息 预升 2014-08-21 -0.0494 36.7
4 600007 中国国贸 预升 2014-08-20 0.23 23.21
5 002125 湘潭电化 预亏 2014-08-19 -0.1721 --
6 300153 科泰电源 预升 2014-08-18 0.07 20.02
7 601668 中国建筑 -- 2014-08-15 0.29 30%
8 600754 锦江股份 预升 2014-08-15 0.2786 10.83
9 002491 通鼎互联 预升 2014-08-14 0.3817 2.22
10 601177 杭齿前进 预升 2014-08-12 0.0373 37.43
限售股解禁¶
以月的形式返回限售股解禁情况，通过了解解禁股本的大小，判断股票上行的压力。可通过设定年份和月份参数获取不同时段的数据。
参数说明：
- year:年份,默认为当前年
- month:解禁月份，默认为当前月
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- code：股票代码
- name：股票名称
- date:解禁日期
- count:解禁数量（万股）
- ratio:占总盘比率
调用方法：
import tushare as ts
ts.xsg_data()
结果显示：
code name date count ratio
0 000100 TCL集团 2015-04-30 79277.10 6.50
1 000859 国风塑业 2015-04-30 14832.75 26.08
2 002526 山东矿机 2015-04-30 15797.95 29.58
3 300026 红日药业 2015-04-30 55.50 0.09
4 300272 开能环保 2015-04-30 14.62 0.06
5 002137 实益达 2015-04-29 65.70 0.14
6 600172 黄河旋风 2015-04-28 777.62 1.12
7 000955 欣龙控股 2015-04-27 3900.00 7.24
8 603000 人民网 2015-04-27 32980.00 59.66
9 002521 齐峰新材 2015-04-26 244.20 0.58
10 300195 长荣股份 2015-04-26 66.60 0.39
基金持股¶
获取每个季度基金持有上市公司股票的数据。
参数说明：
- year:年份,默认为当前年
- quarter:季度（只能输入1，2，3，4这个四个数字）
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- code：股票代码
- name：股票名称
- date:报告日期
- nums:基金家数
- nlast:与上期相比（增加或减少了）
- count:基金持股数（万股）
- clast:与上期相比
- amount:基金持股市值
- ratio:占流通盘比率
调用方法：
import tushare as ts
ts.fund_holdings(2014, 4)
结果显示：
code name date nums nlast count clast amount \
0 603993 洛阳钼业 2014-12-31 108 106 4546.12 4486.11 39778.53
1 603806 福斯特 2014-12-31 3 -5 12.10 -33.07 461.95
2 603766 隆鑫通用 2014-12-31 65 50 2469.13 -1529.92 33185.16
3 603606 东方电缆 2014-12-31 16 0 113.22 81.83 2493.21
4 603456 九洲药业 2014-12-31 18 8 1508.28 1441.44 49230.23
5 603366 日出东方 2014-12-31 68 66 1771.41 1509.48 28750.06
6 603328 依顿电子 2014-12-31 43 42 91.78 51.01 2137.60
7 603308 应流股份 2014-12-31 10 8 288.30 288.10 5166.26
8 603306 华懋科技 2014-12-31 1 -9 3.41 -47.75 86.38
9 603288 海天味业 2014-12-31 135 128 2746.63 2285.18 109727.72
10 603169 兰石重装 2014-12-31 1 -12 0.10 -9.80 1.76
新股数据¶
获取IPO发行和上市的时间列表，包括发行数量、网上发行数量、发行价格已经中签率信息等。
参数说明：
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- code：股票代码
- name：股票名称
- ipo_date:上网发行日期
- issue_date:上市日期
- amount:发行数量(万股)
- markets:上网发行数量(万股)
- price:发行价格(元)
- pe:发行市盈率
- limit:个人申购上限(万股)
- funds：募集资金(亿元)
- ballot:网上中签率(%)
调用方法：
import tushare as ts
ts.new_stocks()
结果显示：
code name ipo_date issue_date amount markets price pe limit \
0 300442 普丽盛 2015-04-16 NaT 2500 1000 0.00 0.00 0.00
1 300434 金石东方 2015-04-16 NaT 1700 680 0.00 0.00 0.00
2 300438 鹏辉能源 2015-04-16 NaT 2100 840 0.00 0.00 0.00
3 002751 易尚展示 2015-04-16 NaT 1756 696 0.00 0.00 0.00
4 300404 博济医药 2015-04-16 NaT 1667 657 0.00 0.00 0.00
5 603021 山东华鹏 2015-04-15 NaT 2640 1040 0.00 0.00 0.00
6 300441 鲍斯股份 2015-04-15 NaT 2112 845 0.00 0.00 0.00
7 603315 福鞍股份 2015-04-15 NaT 2500 1000 0.00 0.00 0.00
8 600959 江苏有线 2015-04-15 NaT 59700 17700 0.00 0.00 0.00
9 300448 浩云科技 2015-04-15 NaT 2000 800 0.00 0.00 0.00
10 300440 运达科技 2015-04-15 NaT 2800 1120 0.00 0.00 0.00
融资融券（沪市）请转移到Tushare Pro 融资融券新接口¶
沪市的融资融券数据从上海证券交易所网站直接获取，提供了有记录以来的全部汇总和明细数据。根据上交所网站提示：数据根据券商申报的数据汇总，由券商保证数据的真实、完整、准确。
- 本日融资融券余额＝本日融资余额＋本日融券余量金额
- 本日融资余额＝前日融资余额＋本日融资买入额－本日融资偿还额；
- 本日融资偿还额＝本日直接还款额＋本日卖券还款额＋本日融资强制平仓额＋本日融资正权益调整－本日融资负权益调整；
- 本日融券余量=前日融券余量+本日融券卖出数量-本日融券偿还量；
- 本日融券偿还量＝本日买券还券量＋本日直接还券量＋本日融券强制平仓量＋本日融券正权益调整－本日融券负权益调整－本日余券应划转量；
- 融券单位：股（标的证券为股票）/份（标的证券为基金）/手（标的证券为债券）。
- 明细信息中仅包含当前融资融券标的证券的相关数据，汇总信息中包含被调出标的证券范围的证券的余额余量相关数据。
沪市融资融券汇总数据
参数说明：
- start:开始日期 format：YYYY-MM-DD 为空时取去年今日
- end:结束日期 format：YYYY-MM-DD 为空时取当前日期
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- opDate:信用交易日期
- rzye:本日融资余额(元)
- rzmre: 本日融资买入额(元)
- rqyl: 本日融券余量
- rqylje: 本日融券余量金额(元)
- rqmcl: 本日融券卖出量
- rzrqjyzl:本日融资融券余额(元)
调用方法：
import tushare as ts
ts.sh_margins(start='2015-01-01', end='2015-04-19')
结果显示：
opDate rzye rzmre rqyl rqylje \
0 2015-04-17 1149157713135 129211438621 819750253 6041055352
1 2015-04-16 1157182044282 112006268973 820992013 5973347250
2 2015-04-15 1146127306376 127637503244 815236850 5760511452
3 2015-04-14 1132444514795 135681414792 808065982 5734278801
4 2015-04-13 1112644681454 125462079457 837423227 6012263982
5 2015-04-10 1093646777627 120171575492 851628036 6013790547
6 2015-04-09 1080032082669 151266260607 950252465 7459280657
7 2015-04-08 1063907515309 146795417745 883306430 6090844298
8 2015-04-07 1049019510305 135205459177 890246879 6052607373
9 2015-04-03 1028339497560 121745692024 833666811 5639393066
rqmcl rzrqjyzl
0 1380227173 1155198768487
1 2203963301 1163155391532
2 2243634120 1151887817828
3 2105259947 1138178793596
4 1717712021 1118656945436
5 1903813388 1099660568174
6 1839296323 1087491363326
7 1811107279 1069998359607
8 1812376621 1055072117678
9 1685019881 1033978890626
沪市融资融券明细数据
参数说明：
- date:日期 format：YYYY-MM-DD 默认为空’‘,数据返回最近交易日明细数据
- symbol：标的代码，6位数字e.g.600848，默认为空’‘
- start:开始日期 format：YYYY-MM-DD 默认为空’‘
- end:结束日期 format：YYYY-MM-DD 默认为空’‘
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- opDate:信用交易日期
- stockCode:标的证券代码
- securityAbbr:标的证券简称
- rzye:本日融资余额(元)
- rzmre: 本日融资买入额(元)
- rzche:本日融资偿还额(元)
- rqyl: 本日融券余量
- rqmcl: 本日融券卖出量
- rqchl: 本日融券偿还量
调用方法：
import tushare as ts
ts.sh_margin_details(start='2015-01-01', end='2015-04-19', symbol='601989')
#如果不设symbol参数或者开始和结束日期时段设置过长，数据获取可能会比较慢，建议分段分步获取，比如一年为一个周期
结果显示：
opDate stockCode securityAbbr rzye rzmre rzche \
0 2015-04-17 601989 中国重工 14252656894 2312839368 2601765162
1 2015-04-16 601989 中国重工 14554040816 2548138684 2829229670
2 2015-04-15 601989 中国重工 14835131802 2107531845 1748705388
3 2015-04-14 601989 中国重工 14476305345 3032554867 2310655239
4 2015-04-13 601989 中国重工 13789855569 1479008826 1205637113
5 2015-04-10 601989 中国重工 13516483857 1168986102 1196101729
6 2015-04-09 601989 中国重工 13543599484 1474071547 1503903339
7 2015-04-08 601989 中国重工 13599709125 1567850413 1489255328
8 2015-04-07 601989 中国重工 13514051054 1709141749 1614928278
9 2015-04-03 601989 中国重工 13411176185 2033773020 1634094504
rqyl rqmcl rqchl
0 2070747 18772355 18677978
1 1976370 107495699 106518076
2 998747 71400666 71855619
3 1453700 107761665 107808218
4 1482253 45963069 46086007
5 1605191 60792818 61117727
6 1930100 38205439 37598326
7 1237814 50049257 50097957
8 1286514 73136275 73024138
9 1174377 103765174 103718451
融资融券（深市）请转移到Tushare Pro 融资融券新接口¶
深市的融资融券数据从深圳证券交易所网站直接获取，提供了有记录以来的全部汇总和明细数据。在深交所的网站上，对于融资融券的说明如下：
说明：
本报表基于证券公司报送的融资融券余额数据汇总生成，其中：
本日融资余额(元)=前日融资余额＋本日融资买入-本日融资偿还额
本日融券余量(股)=前日融券余量＋本日融券卖出量-本日融券买入量-本日现券偿还量
本日融券余额(元)=本日融券余量×本日收盘价
本日融资融券余额(元)=本日融资余额＋本日融券余额；
2014年9月22日起，“融资融券交易总量”数据包含调出标的证券名单的证券的融资融券余额。
深市融资融券汇总数据
参数说明：
- start:开始日期 format：YYYY-MM-DD 为空时取去年今日
- end:结束日期 format：YYYY-MM-DD 为空时取当前日期
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- opDate:信用交易日期(index)
- rzmre: 融资买入额(元)
- rzye:融资余额(元)
- rqmcl: 融券卖出量
- rqyl: 融券余量
- rqye: 融券余量(元)
- rzrqye:融资融券余额(元)
调用方法：
import tushare as ts
ts.sz_margins(start='2015-01-01', end='2015-04-19')
结果显示：
rzmre rzye rqmcl rqyl rqye \
opDate
2015-01-05 38277263968 329575457077 290786402 328745900 2217097425
2015-01-06 37065808766 330337451354 234959735 336234242 2275278509
2015-01-07 30805638905 333570682580 204113638 342875246 2340163403
2015-01-08 28316028226 334537113612 209058725 324338597 2248088027
2015-01-09 29236879032 334096183516 261141219 300986514 2076584482
2015-01-12 24331316036 336071465357 234181290 286924013 1985929255
2015-01-13 22634216323 337225655535 246749378 284409172 1968502622
2015-01-14 23342662784 341201284890 225359998 275175916 1885368528
2015-01-15 23670699950 343792509454 250484696 286478745 1960122114
2015-01-16 29221750218 344702543733 231980680 299066189 2021372924
rzrqye
opDate
2015-01-05 331792554502
2015-01-06 332612729863
2015-01-07 335910845983
2015-01-08 336785201639
2015-01-09 336172767998
2015-01-12 338057394612
2015-01-13 339194158157
2015-01-14 343086653418
2015-01-15 345752631568
2015-01-16 346723916657
深市融资融券明细数据
参数说明：
- date:日期 format：YYYY-MM-DD 默认为空’‘,数据返回最近交易日明细数据
- retry_count：当网络异常后重试次数，默认为3
- pause:重试时停顿秒数，默认为0
返回值说明：
- stockCode:标的证券代码
- securityAbbr:标的证券简称
- rzmre: 融资买入额(元)
- rzye:融资余额(元)
- rqmcl: 融券卖出量
- rqyl: 融券余量
- rqye: 融券余量(元)
- rzrqye:融资融券余额(元)
- opDate:信用交易日期
调用方法：
import tushare as ts
ts.sz_margin_details('2015-04-20')
#深市融资融券明细一次只能获取一天的明细数据，如果不输入参数，则为最近一个交易日的明细数据
结果显示：
stockCode securityAbbr rzmre rzye rqmcl rqyl rqye \
0 000001 平安银行 914150095 5960345469 9598977 1898697 30948760
1 000002 万 科Ａ 1602572463 7422963456 14532967 2843656 40408351
2 000006 深振业Ａ 341727587 1566603285 252419 80590 866343
3 000009 中国宝安 520548152 4076646657 971086 533460 9543599
4 000012 南 玻Ａ 0 710082271 0 665743 7236626
5 000024 招商地产 0 2469445374 0 518556 16573050
6 000027 深圳能源 158004666 1156768901 780641 404882 5729080
7 000028 国药一致 71928528 499539059 26050 33934 2404223
8 000031 中粮地产 275150291 1382171682 813989 250644 2894938
9 000039 中集集团 505792033 2456145597 2514898 644534 17640896
rzrqye opDate
0 5991294229 2015-04-20
1 7463371807 2015-04-20
2 1567469628 2015-04-20
3 4086190256 2015-04-20
4 717318897 2015-04-20
5 2486018424 2015-04-20
6 1162497981 2015-04-20
7 501943282 2015-04-20
8 1385066620 2015-04-20
9 2473786493 2015-04-20