<commit_before>.. contents::
   :depth: 3.0
..

.. \_datayes:

.. currentmodule:: tushare

.. highlightlang:: python

通联数据
========

通联数据（DataYes）是国内目前最大的开放金融数据平台，整合了包括股票、基金、期货、期权和港股方面的全品类金融数据。从数据的多样性、质量性和稳定性的角度考虑，遵从TuShare一贯的开放、简单易用的特点，TuShare为用户集成了绝大部分通联数据的接口。虽然通联数据大部分数据接口都是免费使用，但毕竟是一家商业公司，使用前提是需要注册通联数据的用户账号，当然，注册过程还是相当简单的。

为了让TuShare用户更好的使用通联数据接口，请大家按以下步骤注册和操作，以便能顺利调用通联数据接口，用户注册必须从以下TuShare网站提供的链接进入注册环节，否则将不提供技术支持和服务。

另外，为了更好地提供服务以及方便用户进行接口使用经验交流，专门申请了通联数据的QQ服务群：488918622，请注册好通联数据账号后，将用户名作为QQ群的入群验证码发送进来方可加群，QQ群将不定期给符合要求的用户开通长期使用权限。

用户注册
--------

打开\ `通联数据 <http://router.wmcloud.com/6>`__\ 首页(http://router.wmcloud.com/6)，并点击“注册”按钮，进入用户注册界面：

.. figure:: _static/1.png
   :alt: 

选择“个人”，进入用户信息界面填写个人信息，为了在QQ群里能迅速定位个人的问题，强烈建议您用qq邮箱注册通联数据的账号：

.. figure:: _static/2.png
   :alt: 

通过邮箱注册账号，会收到验证邮件，通过点击邮件里的链接，设置通联数据的账号密码完成注册。

获取token
---------

登录通联数据账户，进入应用列表界面，点击“数据开放平台”，进入开放平台首页：

.. figure:: _static/3.png
   :alt: 

点击“我的数据”->“开发者选项”->“成为开发者”：

.. figure:: _static/7.png
   :alt: 

然后，点击“我的凭证”->“显示凭证”，看到token字符串之后拷贝，之后会在接口调用的时候使用。

.. figure:: _static/4.png
   :alt: 

调用方法
--------

在安装TuShare后，或者在调用通联数据接口前，需要先设置通联数据账户的token凭证码（只需设置一次，如果重新生成token，需要在TuShare里重新设置token码），方法如下：

::

    import tushare as ts
    ts.set_token('<KEY>')

查看自己的token码，方法如下：

::

    ts.get_token()

获取某一类数据： mkt = ts.Market() df =
mkt.TickRTSnapshot(securityID='000001.XSHE')

证券概况
--------

可以查询机构ID编码，证券ID编码，证券上市信息，证券板块分类以及交易所交易日历等信息。所有证券概况的方法都在Master()类里，可以查询到以下数据：

-  SecID--证券编码及基本上市信息
-  TradeCal --交易所交易日历
-  Industry --行业分类标准
-  EquInfo --沪深股票键盘精灵
-  SecTypeRegionRel --沪深股票地域分类
-  SecTypeRegion --地域分类
-  SecTypeRel --证券板块成分
-  SecType --证券板块
-  SysCode --参数常量值集合

具体的调用参数和返回的field字段可以通过查看文档自行设定，文档地址：
https://app.wmcloud.com/open/api?lang=zh

调用样例：

::

    #获取一段时间内的日期是否为交易日，isOpen=1是交易日，isOpen=0为休市
    mt = ts.Master()
    df = mt.TradeCal(exchangeCD='XSHG', beginDate='20150928', endDate='20151010', field='calendarDate,isOpen,prevTradeDate')

返回结果：

::

       calendarDate  isOpen prevTradeDate
    0    2015-09-28       1    2015-09-25
    1    2015-09-29       1    2015-09-28
    2    2015-09-30       1    2015-09-29
    3    2015-10-01       0    2015-09-30
    4    2015-10-02       0    2015-09-30
    5    2015-10-03       0    2015-09-30
    6    2015-10-04       0    2015-09-30
    7    2015-10-05       0    2015-09-30
    8    2015-10-06       0    2015-09-30
    9    2015-10-07       0    2015-09-30
    10   2015-10-08       1    2015-09-30
    11   2015-10-09       1    2015-10-08
    12   2015-10-10       0    2015-10-09

通过查看通联数据的文档，可以获取以下详细信息，根据自己的实际需要来设定：

.. figure:: _static/5.png
   :alt: 

行情数据
--------

市场行情数据API提供实时市场行情数据快照，当天市场行情数据分钟线，历史日线数据和历史市场高频数据（level1)。
证券种类涵盖股票，指数，债券，基金；数据涵盖在上证（XSHG）和深圳（XSHE）交易的证券以及港股（XHKG）证券，港股目前仅支持一档行情。所有行情数据的方法都在Market()类里。

-  TickRTSnapshot --获取最新市场信息快照
-  TickRTSnapshotIndex --获取指数成份股的最新市场信息快照
-  IndustryTickRTSnapshot --获取行业资金流向
-  FutureTickRTSnapshot --获取期货最新市场信息快照
-  OptionTickRTSnapshot --获取期权最新市场信息快照
-  SecTips --沪深股票今日停复牌
-  EquRTRank --获取沪深股票涨跌幅排行
-  TickRTIntraDay --获取一只股票,指数,债券,基金在当日内时间段Level1信息
-  BarRTIntraDay --获取当日分钟线
-  BarRTIntraDayOneMinute --获取所有股票某一分钟的分钟线
-  FutureBarRTIntraDay --获取当日期货分钟线<commit_msg>doc update<commit_after>.. contents::
   :depth: 3.0
..

.. \_datayes:

.. currentmodule:: tushare

.. highlightlang:: python

通联数据
========

通联数据（DataYes）是国内目前最大的开放金融数据平台，整合了包括股票、基金、期货、期权和港股方面的全品类金融数据。从数据的多样性、质量性和稳定性的角度考虑，遵从TuShare一贯的开放、简单易用的特点，TuShare为用户集成了绝大部分通联数据的接口。虽然通联数据大部分数据接口都是免费使用，但毕竟是一家商业公司，使用前提是需要注册通联数据的用户账号，当然，注册过程还是相当简单的。

为了让TuShare用户更好的使用通联数据接口，请大家按以下步骤注册和操作，以便能顺利调用通联数据接口，用户注册必须从以下TuShare网站提供的链接进入注册环节，否则将不提供技术支持和服务。

另外，为了更好地提供服务以及方便用户进行接口使用经验交流，专门申请了通联数据的QQ服务群：488918622，请注册好通联数据账号后，将用户名作为QQ群的入群验证码发送进来方可加群，QQ群将不定期给符合要求的用户开通长期使用权限。

用户注册
--------

打开\ `通联数据 <http://router.wmcloud.com/6>`__\ 首页(http://router.wmcloud.com/6)，并点击“注册”按钮，进入用户注册界面：

.. figure:: _static/1.png
   :alt: 

选择“个人”，进入用户信息界面填写个人信息，为了在QQ群里能迅速定位个人的问题，强烈建议您用qq邮箱注册通联数据的账号：

.. figure:: _static/2.png
   :alt: 

通过邮箱注册账号，会收到验证邮件，通过点击邮件里的链接，设置通联数据的账号密码完成注册。

获取token
---------

登录通联数据账户，进入应用列表界面，点击“数据开放平台”，进入开放平台首页：

.. figure:: _static/3.png
   :alt: 

点击“我的数据”->“开发者选项”->“成为开发者”：

.. figure:: _static/7.png
   :alt: 

然后，点击“我的凭证”->“显示凭证”，看到token字符串之后拷贝，之后会在接口调用的时候使用。

.. figure:: _static/4.png
   :alt: 

调用方法
--------

在安装TuShare后，或者在调用通联数据接口前，需要先设置通联数据账户的token凭证码（只需设置一次，如果重新生成token，需要在TuShare里重新设置token码），方法如下：

::

    import tushare as ts
    ts.set_token('<KEY>')

查看自己的token码，方法如下：

::

    ts.get_token()

获取某一类数据： mkt = ts.Market() df =
mkt.TickRTSnapshot(securityID='000001.XSHE')

证券概况
--------

可以查询机构ID编码，证券ID编码，证券上市信息，证券板块分类以及交易所交易日历等信息。所有证券概况的方法都在Master()类里，可以查询到以下数据：

-  SecID--证券编码及基本上市信息
-  TradeCal --交易所交易日历
-  Industry --行业分类标准
-  EquInfo --沪深股票键盘精灵
-  SecTypeRegionRel --沪深股票地域分类
-  SecTypeRegion --地域分类
-  SecTypeRel --证券板块成分
-  SecType --证券板块
-  SysCode --参数常量值集合

具体的调用参数和返回的field字段可以通过查看文档自行设定，文档地址：
https://app.wmcloud.com/open/api?lang=zh

调用样例：

::

    #获取一段时间内的日期是否为交易日，isOpen=1是交易日，isOpen=0为休市
    mt = ts.Master()
    df = mt.TradeCal(exchangeCD='XSHG', beginDate='20150928', endDate='20151010', field='calendarDate,isOpen,prevTradeDate')

返回结果：

::

       calendarDate  isOpen prevTradeDate
    0    2015-09-28       1    2015-09-25
    1    2015-09-29       1    2015-09-28
    2    2015-09-30       1    2015-09-29
    3    2015-10-01       0    2015-09-30
    4    2015-10-02       0    2015-09-30
    5    2015-10-03       0    2015-09-30
    6    2015-10-04       0    2015-09-30
    7    2015-10-05       0    2015-09-30
    8    2015-10-06       0    2015-09-30
    9    2015-10-07       0    2015-09-30
    10   2015-10-08       1    2015-09-30
    11   2015-10-09       1    2015-10-08
    12   2015-10-10       0    2015-10-09

通过查看通联数据的文档，可以获取以下详细信息，根据自己的实际需要来设定：

.. figure:: _static/5.png
   :alt: 

   
行情数据
--------

市场行情数据API提供实时市场行情数据快照，当天市场行情数据分钟线，历史日线数据和历史市场高频数据（Level1)。
证券种类涵盖股票，指数，债券，基金；数据涵盖在上证（XSHG）和深圳（XSHE）交易的证券以及港股（XHKG）证券，港股目前仅支持一档行情。所有行情数据的方法都在Market()类里。

-  TickRTSnapshot --获取最新市场信息快照
-  TickRTSnapshotIndex --获取指数成份股的最新市场信息快照
-  IndustryTickRTSnapshot --获取行业资金流向
-  FutureTickRTSnapshot --获取期货最新市场信息快照
-  OptionTickRTSnapshot --获取期权最新市场信息快照
-  SecTips --沪深股票今日停复牌
-  EquRTRank --获取沪深股票涨跌幅排行
-  TickRTIntraDay --获取一只股票,指数,债券,基金在当日内时间段Level1信息
-  BarRTIntraDay --获取当日分钟线
-  BarRTIntraDayOneMinute --获取所有股票某一分钟的分钟线
-  FutureBarRTIntraDay --获取当日期货分钟线
{'fraction_non_alphanumeric': 0.13788800499142098, 'fraction_numerical': 0.08797379503977538, 'mean_word_length': 3.229551451187335, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 13, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '867012', 'n_tokens_mistral': 4340, 'n_tokens_neox': 4584, 'n_words': 336}