vipstock 0.0.2
A small api package for vip.stock
Requires Python: >=3.6
Keywords: vipstock,sinastock,api,web

**VipStock**

VipStockPro版尚未发布，请访问个人官网了解和期待！ [[Iseuwei的微博](https://weibo.com/5331698381/info))

VipStock是实现对股票/期货等金融数据从**数据采集**、**清洗加工** 到 **数据存储**过程的工具，满足金融量化分析师和学习数据分析的人在数据获取方面的需求，它的特点是数据覆盖范围广，接口调用简单,响应快速。



欢迎关注扫描VipStock的微信公众号“安乐窝”，更多资源和信息与您分享。另外，由于vipstock官网在重新设计和开发，最新接口的使用文档都会在挖地兔公众号发布，所以，请扫码关注，谢谢！

![](https://qr.weibo.cn/inf/gen?api_key=bdc93f6ac5325648182fee881dd17f52&size=128&type=url&redirect=0&margin=0&data=http%3A%2F%2Fwww.weibo.com%2Fp%2F1005055331698381%3Ffrom%3Dqrcode&output_type=img&title=page_web_qrshow&datetime=nocheck&sign=268d9c0b12bbc058472869b51e0488ab)

QQ交流群：

- 一群（欢迎ing）：2836084073



Dependencies
=========
python 2.x/3.x   

[pandas](http://pandas.pydata.org/ "pandas")


Installation
====

	pip install vipstock


Upgrade
=======

	pip install vipstock --upgrade



Quick Start
======



**一、投资参考**

> 初始化：

```
from VipStock import crawl
vs=crawl.VipStock()
```

1、交易提示：

    vs.InvestConsult(kind='交易提示')
    vs.pd_to_excel('交易提示.xlsx', vs.df_search)

输出显示：

                                                    停牌  Unnamed: 1
    0              (600179) *ST安通：关于公司股票撤销退市风险警示暨停牌的公告         NaN
    1         (600215) *ST经开：*ST经开关于公司股票撤销退市风险警示暨停牌的公告         NaN
    2          (600243) *ST海华：青海华鼎关于公司股票撤销退市风险警示暨停牌的公告         NaN
    3            (600906) 财达证券：关于N财达 （600906）盘中临时停牌的公告         NaN
    4     (603518) 锦泓集团：锦泓时装集团股份有限公司关于股票交易异常波动暨停牌核查的公告         NaN

2、融资融券：

    vs.InvestConsult(kind='融资融券')

输出显示：

         融资融券交易明细 融资融券交易明细.1 融资融券交易明细.2  ... 融资融券交易明细.8 融资融券交易明细.9    融资融券交易明细.10
    0          序号       股票代码       股票名称  ...         融券         融券             融券
    1          序号       股票代码       股票名称  ...     卖出量(股)     偿还量(股)        融券余额(元)
    2           1     000001       平安银行  ...    1576900         --  4572470210.00
    3           2     000002        万科A  ...      65400         --  9011087979.00
    4           3     000006       深振业A  ...      72800         --   482250125.00
    ...       ...        ...        ...  ...        ...        ...            ...
    1960     1959     688777       中控技术  ...      18198      44607             --
    1961     1960     688788       科思科技  ...          0          0             --
    1962     1961     688819       天能股份  ...      45032      16400             --
    1963     1962     688981       中芯国际  ...     351851    1067800             --
    1964     1963     689009       九号公司  ...       3700          0             --

指定上市公司和时间区间：

```
vs.InvestConsult(kind='融资融券', symbol="000002", bdate="2020-05-01", edate="2021-05-01", pn=1)
```

        万科A 融资融券交易明细 万科A 融资融券交易明细.1  ... 万科A 融资融券交易明细.8   万科A 融资融券交易明细.9
    0             序号             日期  ...             融券               融券
    1             序号             日期  ...            偿还量             融券余额
    2              1     2021-04-30  ...             --  9179448328.0000
    3              2     2021-04-29  ...             --  9439455079.0000
    4              3     2021-04-28  ...             --  9437883813.0000
    ..           ...            ...  ...            ...              ...
    240          239     2020-05-12  ...             --  3942058488.0000
    241          240     2020-05-11  ...             --  3847647570.0000
    242          241     2020-05-08  ...             --  3798189063.0000
    243          242     2020-05-07  ...             --  3543858126.0000
    244          243     2020-05-06  ...             --  3458102043.0000
3、大宗交易：

    vs.InvestConsult(kind='大宗交易')

输出显示：

              交易日期    证券代码  ...                      卖方营业部  证券类型
    0   2021-05-06  002415  ...                       机构专用    A股
    1   2021-05-06  300803  ...       兴业证券股份有限公司厦门穆厝路证券营业部    A股
    2   2021-05-06  300323  ...       海通证券股份有限公司义乌宾王路证券营业部    A股
    3   2021-05-06  600867  ...      华安证券股份有限公司上海浦东南路证券营业部    A股
    4   2021-05-06  002314  ...    第一创业证券股份有限公司深圳深南大道证券营业部    A股
    5   2021-05-06  300663  ...      东北证券股份有限公司晋江世纪大道证券营业部    A股
    6   2021-05-06  300759  ...  中国国际金融股份有限公司北京建国门外大街证券营业部    A股
    7   2021-05-06  300572  ...                       机构专用    A股
    8   2021-05-06  300759  ...  中国国际金融股份有限公司北京建国门外大街证券营业部    A股
    9   2021-05-06  002594  ...                       机构专用    A股
    10  2021-05-06  000001  ...                       机构专用    A股

指定上市公司和时间区间：

```
vs.InvestConsult(kind='大宗交易', symbol="000002", bdate="2020-05-01", edate="2021-05-01", pn=1)
```

              交易日期    证券代码  ...                       卖方营业部  证券类型
    0   2021-04-28  000002  ...                        机构专用    A股
    1   2021-04-28  000002  ...                        机构专用    A股
    2   2021-04-15  000002  ...             长江证券股份有限公司上海分公司    A股
    3   2021-04-15  000002  ...        中信证券股份有限公司上海东方路证券营业部    A股
    4   2021-04-15  000002  ...                        机构专用    A股
    5   2021-04-15  000002  ...                        机构专用    A股
    6   2021-04-15  000002  ...  东方证券股份有限公司上海黄浦区中山南路第一证券营业部    A股
    7   2021-04-15  000002  ...                        机构专用    A股
    8   2021-04-15  000002  ...                        机构专用    A股
    9   2021-04-15  000002  ...    中信建投证券股份有限公司揭阳黄岐山大道证券营业部    A股

4、内部交易：

    vs.InvestConsult(kind='内部交易')

输出显示：

          股票代码   股票名称          变动人  变动类型  ...        变动日期 持股种类  与董监高关系  董监高职务
    0   600099   林海股份           袁伟    购买  ...  2021-04-30   A股      本人     监事
    1   600122  *ST宏图          王家琪    --  ...  2021-04-30   A股      本人   独立董事
    2   600500   中化国际          刘红生    购买  ...  2021-04-30   A股      本人     董事
    3   600500   中化国际          秦晋克    购买  ...  2021-04-30   A股      本人  首席财务官
    4   600425   青松建化          宁沉浮    购买  ...  2021-04-30   A股      本人     董事
    5   603323   苏农银行          徐卫忠    购买  ...  2021-04-30   A股      本人   行长助理
    6   300063   天龙集团           王娜    出售  ...  2021-04-30   A股      本人  非独立董事
    7   603002   宏昌电子          江胜宗    购买  ...  2021-04-30   A股      本人  非独立董事
    8   603002   宏昌电子          林仁宗    购买  ...  2021-04-30   A股      本人  非独立董事
    9   603002   宏昌电子          林瑞荣    购买  ...  2021-04-30   A股      本人    董事长
    10  300253   卫宁健康           靳茂  股权奖励  ...  2021-04-30   A股      本人     董事

指定上市公司和时间区间：

```
vs.InvestConsult(kind='内部交易', symbol="000002", bdate="2020-05-01", edate="2021-05-01", pn=1)
```

         股票代码 股票名称  变动人 变动类型 变动股数  ... 变动原因        变动日期  持股种类 与董监高关系   董监高职务
    0  000002  万科A   郁亮   --   --  ...  NaN  2020-12-31    A股     本人      董事
    1  000002  万科A   解冻   --   --  ...  NaN  2020-12-31    A股     本人      监事
    2  000002  万科A  阙东武   --   --  ...  NaN  2020-12-31    A股     本人  职工代表监事
    3  000002  万科A   郁亮   --   --  ...  NaN  2020-06-30    A股     本人      董事
    4  000002  万科A   解冻   --   --  ...  NaN  2020-06-30    A股     本人      监事
    5  000002  万科A  阙东武   --   --  ...   增持  2020-06-30    A股     本人  职工代表监事
    6  000002  万科A  王文金   --   --  ...  NaN  2020-06-30    A股     本人    执行董事
    7  000002  万科A   张旭   --   --  ...  NaN  2020-06-30    A股     本人   非独立董事
    8  000002  万科A  周清平   --   --  ...  NaN  2020-06-30    A股     本人    职工监事

5、限售解禁：

    vs.InvestConsult(kind='限售解禁')

输出显示：

            代码    名称        解禁日期  解禁数量(万股)  解禁股流通市值(亿元)  上市批次        公告日期
    0   300642  透景生命  2021-04-30     19.52       0.1305     9  2018-02-09
    1   688133  泰坦科技  2021-04-30     68.93       1.2360     2  2020-10-29
    2   002459  晶澳科技  2021-04-30  24413.15      68.2836     6  2020-10-29
    3   002891  中宠股份  2021-04-30   1737.33       8.9872     5  2020-10-29
    4   002579  中京电子  2021-04-30   9460.58      11.0216    17  2020-10-28
    5   002683  宏大爆破  2021-04-30   3156.34       8.8157    10  2020-10-28
    6   002983   芯瑞达  2021-04-30    501.43       1.3604     2  2020-04-27
    7   002645  华宏科技  2021-04-30   1803.25       2.6868     8  2020-04-14
    8   688366  昊海生科  2021-04-30   1660.00      22.2457     4  2019-10-29
    9   603160  汇顶科技  2021-04-30      7.08       0.0774    14  2020-02-18

按名称/代码：

```
vs.InvestConsult(kind='限售解禁', symbol="000002", pn=1)
```

           代码   名称        解禁日期  解禁数量(万股)  解禁股流通市值(亿元)  上市批次        公告日期
    0  000002  万科A  2009-12-29  26400.00      26.8752     7  2006-12-25
    1  000002  万科A  2007-12-27  43500.00      44.2830     6  2006-12-25
    2  000002  万科A  2007-12-06  24797.17      25.2435     5  2007-03-20
    3  000002  万科A  2006-12-06  33195.75      33.7933     3  2006-12-05

按解禁日期：

```
vs.InvestConsult(kind='限售解禁', bdate="2020-05-01", edate="2021-05-07", pn=1)
```

            代码    名称        解禁日期  解禁数量(万股)  解禁股流通市值(亿元)  上市批次        公告日期
    0   002609  捷顺科技  2021-05-07    328.26       0.3253    40  2019-03-25
    1   300900  广联航空  2021-05-07    250.00       0.7730     2  2020-10-28
    2   300831  派瑞股份  2021-05-07  10448.42      12.6635     2  2020-05-06
    3   002987   京北方  2021-05-07   2655.43      11.9601     2  2020-05-06
    4   300763  锦浪科技  2021-05-07     59.95       1.2343     3  2020-04-30
    5   300606   金太阳  2021-05-07    144.24       0.2547     6  2020-04-22

6、千股千评：

    vs.InvestConsult(kind='千股千评', pn=1)

输出显示：

            代码    名称                       千股千评  ...     最低    成交量(万股)    成交额(万元)
    0   600000  浦发银行        具备中长期投资价值，但不是短线交易时机  ...   9.99    5633.51   56851.30
    1   600004  白云机场          业绩平稳，走势较弱，短期需持币观望  ...  11.54    1412.67   16475.02
    2   600006  东风汽车                 基本面差，短期需观望  ...   6.37    3326.56   21364.52
    3   600007  中国国贸       业绩不错，走势较强，短期回档后应考虑低吸  ...  14.86    1066.47   16277.79
    4   600008  首创股份      业绩一般，走势一般，建议趋势明朗后进行交易  ...   2.94    2118.98    6283.86
    5   600009  上海机场                 业绩疲软，短期需观望  ...  45.09    2091.69   95999.78

按所属行业、概念、投资评级、时间区间筛选，并对结果进行排序：

```
vs.InvestConsult(kind='千股千评', industry=None, concept="光伏概念", suggest="买入",
               		bdate="2020-04-30", edate="2021-04-30", symbol=None, pn=1, num=600, order="symbol|1")
```

           代码↑    名称                              千股千评  ...     最低  成交量(万股)    成交额(万元)
    0   600089  特变电工              业绩不错，走势较强，短期回档后应考虑低吸  ...  12.13  8700.07  106891.97
    1   600207  安彩高科         看好长期前景，且走势强劲，短线回档时可考虑低吸布局  ...   6.10  2047.72   12749.00
    2   601137  博威合金                业绩一般，但短期走势加强，可考虑低吸  ...  10.88   587.75    6487.75
    3   603806   福斯特  具备中长期投资价值，且处于强势多头阶段，短线回档时可考虑低吸布局  ...  82.58   579.20   49270.09
    4   000821  京山轻机                业绩一般，但短期走势加强，可考虑低吸  ...   7.90  1703.81   13749.41
    5   000959  首钢股份  具备中长期投资价值，且处于强势多头阶段，短线回档时可考虑低吸布局  ...   5.32  7435.88   40960.99
    6   002006  精功科技                业绩一般，但短期走势加强，可考虑低吸  ...   6.10   608.51    3742.80
    7   002139  拓邦股份              业绩不错，走势较强，短期回档后应考虑低吸  ...  12.99  5524.50   74041.25
    8   002516  旷达科技                业绩一般，但短期走势加强，可考虑低吸  ...   3.29   594.27    1972.00
    9   300093  金刚玻璃                业绩一般，但短期走势加强，可考虑低吸  ...  18.72   389.08    7439.92
    10  300102  乾照光电         看好长期前景，且走势强劲，短线回档时可考虑低吸布局  ...   6.72  6636.19   45937.98
    11  300125  聆达股份                业绩平淡，但短期走势加强，可考虑低吸  ...  14.42   102.67    1512.29

7、打新收益：

    vs.InvestConsult(kind='打新收益', pn=1)

输出显示：

          证券代码    申购代码    名称        上市日期  ...  涨跌幅(%)      收益   发行价格    发行数量
    0   600905  730905  三峡能源           -  ...    0.00  0.0000   2.65  857100
    1   605296  707296  神农集团           -  ...    0.00  0.0000  56.08    4003
    2   601665  780665  齐鲁银行           -  ...    0.00  0.0000   0.00   45808
    3   605499  707499  东鹏饮料           -  ...    0.00  0.0000   0.00    4001
    4   603836  732836  海程邦达           -  ...    0.00  0.0000   0.00    5131
    5   603511  732511  爱慕股份           -  ...    0.00  0.0000  20.99    4001

8、历史分红：

    vs.InvestConsult(kind='历史分红', pn=1)

输出显示：

            代码    名称        上市日期  累计股息(%)  年均股息(%)  分红次数   融资总额(亿)  融资次数  详细
    0   000541  佛山照明  1993-11-23    174.9     6.48    48    0.0000     0  详细
    1   000550  江铃汽车  1993-12-01    165.0     6.11    43    0.0000     0  详细
    2   000726   鲁泰A  2000-12-25    132.8     6.64    39    9.5082     1  详细
    3   000022  深赤湾A  1993-05-05    132.3     5.09    45    0.0000     0  详细
    4   000429  粤高速A  1998-02-20    123.8     5.38    42   16.3350     1  详细
    5   000539  粤电力A  1993-11-26    122.3     4.53    49    8.0981     1  详细



**二、机构荐股池**

> 初始化：

```
from VipStock import crawl
vs=crawl.VipStock()
```

0、个股投资评级：

    vs.IR_Rating(kind='个股投资评级', last=90, symbol="000568", pn=1, num=None, order=None)

输出显示：

          股票代码  股票名称     目标价 最新评级    评级机构  ...  摘要 最新价 涨跌幅  收藏  股吧
    0   000568  泸州老窖     NaN   买入    中银证券  ...  摘要 NaN NaN NaN NaN
    1   000568  泸州老窖     NaN   买入    浙商证券  ...  摘要 NaN NaN NaN NaN
    2   000568  泸州老窖     NaN   买入    国海证券  ...  摘要 NaN NaN NaN NaN
    3   000568  泸州老窖     NaN   买入    光大证券  ...  摘要 NaN NaN NaN NaN
    4   000568  泸州老窖     NaN   买入    西部证券  ...  摘要 NaN NaN NaN NaN
    5   000568  泸州老窖     NaN   买入    国信证券  ...  摘要 NaN NaN NaN NaN

1、最新投资评级：

    vs.IR_Rating(kind='最新投资评级', pn=1, num=None, order=None)

2、上调评级股票：

    vs.IR_Rating(kind='上调评级股票', pn=1, num=None, order=None)

3、下调评级股票：

    vs.IR_Rating(kind='下调评级股票', pn=1, num=None, order=None)

4、股票综合评级：

    vs.IR_Rating(kind='股票综合评级', last=30, pn=1, num=None, order=None)

5、首次评级股票：

    vs.IR_Rating(kind='首次评级股票', pn=1, num=None, order=None)

6、目标涨幅排名：

    vs.IR_Rating(kind='目标涨幅排名', last=180, pn=1, num=None, order=None)

7、机构关注度：

    vs.IR_Rating(kind='机构关注度', last=60, pn=1, num=None, order=None)

8、行业关注度：

    vs.IR_Rating(kind='行业关注度', last=90, pn=1, num=None, order=None)

**三、龙虎榜**

    vs.LHBData(kind='个股上榜统计', last=None, symbol=None, bdate="2020-04-30", edate="2021-04-30", pn=1, 					num=None)

输出显示：

          股票代码   股票名称  上榜次数   累积购买额(万)   累积卖出额(万)      净额(万)  买入席位数  卖出席位数
    0   600196   复星医药     2  397015.10  284587.70  112427.40      7      8
    1   000825   太钢不锈     1   56523.23   17752.73   38770.50      4      5
    2   601015   陕西黑猫     1   40974.52   23855.39   17119.13      5      5
    3   600007   中国国贸     1   19535.18    6720.31   12814.87      4      5
    4   300986   志特新材     1   13239.55    1709.29   11530.25      5      3
    5   000718   苏宁环球     1   47345.48   36237.30   11108.18      5      5



**四、市场表现**

    vs.HqStat(kind='连续放量个股', pn=3, num=500, sort="day_con", asc=0)

输出显示：

           symbol  name    close     volume  ...         day flag1 flag_con short_name
    0    sz000718  苏宁环球   7.0000  267359160  ...  2021-05-06     0        0       苏宁环球
    1    sh688028   沃尔德  37.4000    3827088  ...  2021-05-06     0        0        沃尔德
    2    sh603933  睿能科技  13.5000   26101278  ...  2021-05-06     0        0       睿能科技
    3    sz000790  华神科技   6.3600   86473532  ...  2021-05-06     0        0       华神科技
    4    sz002172  澳洋健康   5.2300  144798522  ...  2021-05-06     0        0       澳洋健康

**五、财务分析**

    vs.FinanceAnalyze(kind='业绩报表', industry='金融行业', area='上海市', year='2021', Q=1, pn=1, order=None)

输出显示：

         股票代码   股票名称  每股收益(元)  每股收益同比(%)  ... 净利润同比(%)  分配方案  发布日期↓  详细
    0  601328   交通银行     0.30      20.00  ...     2.31    --  04-30  详细
    1  600958   东方证券     0.16      33.33  ...    44.67    --  04-30  详细
    2  600816  *ST安信    -0.13       9.29  ...     9.29    --  04-30  详细
    3  601788   光大证券     0.15     -37.50  ...   -36.88    --  04-30  详细
    4  600000   浦发银行     0.61       8.93  ...     7.70    --  04-30  详细
    5  600837   海通证券     0.28      40.00  ...    58.48    --  04-29  详细

**六、业绩预测**

    vs.PerformancePrediction(kind='每股收益预测', symbol=None, orgname=None, pn=1, num=None)

输出显示：

            股票代码  ...                                                 研报
    0   sh601633  ...  http://stock.finance.sina.com.cn/stock/go.php/...
    1   sz000625  ...  http://stock.finance.sina.com.cn/stock/go.php/...
    2   sz002594  ...  http://stock.finance.sina.com.cn/stock/go.php/...
    3   sh603809  ...  http://stock.finance.sina.com.cn/stock/go.php/...
    4   sz300258  ...  http://stock.finance.sina.com.cn/stock/go.php/...
    5   sz300580  ...  http://stock.finance.sina.com.cn/stock/go.php/...

**七、机构持股**

    vs.ComStockHold(kind='基金重仓股', symbol=None, year='2021', Q=1, pn=3, num=600, order='num|2')

输出显示：

             代码    简称        截至日期  家数  ...  同上期增减(万股)  持股比例(%)  上期家数     明细
    0    600006  东风汽车  2021-03-31   5  ...   758.1212     0.51     2  +展开明细
    1    600009  上海机场  2021-03-31   2  ... -1490.8965     1.66     2  +展开明细
    2    600012  皖通高速  2021-03-31   1  ...   -46.9501     0.21     1  +展开明细
    3    600026  中远海能  2021-03-31   3  ...  1625.5724     1.90     3  +展开明细
    4    600030  中信证券  2021-03-31   1  ...   813.1850     1.42     1  +展开明细

**八、投资评级选股**

    vs.IR_CustomSearch(kind='投资评级选股', market=None, industry=None, area=None, concept=None, last=30, 							suggest='中性', suggest2='中性', sprice=None, pn=None, num=None, order=None)

输出显示：

          股票代码   股票名称 最新评级    目标价       评级日期↓ 综合评级  ...        行业  摘要 最新价 涨跌幅  收藏  股吧
    0   000709   河钢股份   中性   2.60  2021-05-06   中性  ...        钢铁  摘要 NaN NaN NaN NaN
    1   002310   东方园林   中性   3.70  2021-05-06   中性  ...      园林工程  摘要 NaN NaN NaN NaN
    2   603111   康尼机电   中性   6.58  2021-05-06   中性  ...      运输设备  摘要 NaN NaN NaN NaN
    3   601579  会 稽 山   中性   8.95  2021-05-06   中性  ...      饮料制造  摘要 NaN NaN NaN NaN
    4   002664   长鹰信质   中性  13.00  2021-05-06   中性  ...      航空装备  摘要 NaN NaN NaN NaN
    5   601011  宝 泰 隆   中性   3.98  2021-05-06   中性  ...      煤炭开采  摘要 NaN NaN NaN NaN

**九、研报搜索**

    vs.Report_List(kind='研报搜索', orgname="兴业证券股份有限公司", symbol=None, author=None, pubdate=None, pn=3, 				num=600, order="1")

输出显示：

                                                        序号  ...                    研究员
    0    http://stock.finance.sina.com.cn/stock/go.php/...  ...                    张志扬
    1    http://stock.finance.sina.com.cn/stock/go.php/...  ...                  王锟/蔡屹
    2    http://stock.finance.sina.com.cn/stock/go.php/...  ...                徐佳熹/孙媛媛
    3    http://stock.finance.sina.com.cn/stock/go.php/...  ...                    张志扬
    4    http://stock.finance.sina.com.cn/stock/go.php/...  ...  张晓云/王品辉/王春环/吉理/孙修远/郭军
    ..                                                 ...  ...                    ...
    595  http://stock.finance.sina.com.cn/stock/go.php/...  ...            邱祖学/赖丹丹/于嘉懿
    596  http://stock.finance.sina.com.cn/stock/go.php/...  ...             石康/李博彦/李雅哲
    597  http://stock.finance.sina.com.cn/stock/go.php/...  ...                 石康/李博彦
    598  http://stock.finance.sina.com.cn/stock/go.php/...  ...                 孟杰/王翩翩
    599  http://stock.finance.sina.com.cn/stock/go.php/...  ...             傅慧芳/陈绍兴/李英











更多文档
========




Change Logs
-----------

0.0.1 2021/05/07
======

- 编写说明文档