qhsdk 0.0.4

A tools for www.qhkch.com!

qhsdk

(本文档更新于 2019-11-10; 如发现库和文档相关问题, 请联系 qhsdk 的作者 Albert King: [e-mail])

您也可以加入QQ群答疑解难: 326900231

qhsdk 的介绍

qhsdk 于 2019-11-11 正式发布, 请访问 qhsdk文档 了解和查询数据接口！

qhsdk 是基于 Python 的开源金融数据接口库, 目的是实现对股票, 期货, 期权, 基金, 外汇, 债券, 指数, 数字货币等金融产品的基本面数据、实时和历史行情数据、衍生数据从数据采集, 数据清洗, 到数据落地的一套开源工具, 满足金融数据科学家, 数据科学爱好者在金融数据获取方面的需求.

qhsdk 的特点是获取的是相对权威的金融数据网站公布的原始数据, 广大数据科学家可以利用原始数据进行各数据源之间的交叉验证, 进而再加工, 从而得出科学的结论.

qhsdk 后续会基于学术论文和金融工程研究报告来添加更多指标, 提供相应的计算方法, 敬请关注.

qhsdk 的服务于 www.qhkch.com

qhsdk 的特色

qhsdk 主要改进如下:

1. Python 语法符合 PEP8 规范, 统一接口函数的命名;

2. 支持 Python 3.7 以上版本;

3. 持续维护由于目标网页变化而导致的部分函数运行异常问题;

   3.1 增加奇货可查网站数据接口, 提供奇货可查指数数据(开发中);

4. 提供完善的接口文档, 提高 qhsdk 的易用性;

安装方法

pip install qhsdk

升级方法

p.s. 由于目前版本更新迭代比较频繁, 请在使用前先升级库

pip install qhsdk --upgrade

快速入门

1. 先按照 Anaconda安装说明及环境配置

2. 查看 qhsdk 提供的数据接口

Example 2.1 查看 qhsdk 提供的数据接口

代码:

import qhsdk as qh
[item for item in dir(qh) if item.startswith("get")]

结果显示: 数据获取函数说明

 # 奇货可查数据
 'index'  # 获取奇货可查-指数-数值数据
 'index_profit_loss'  # 获取奇货可查-指数-累计盈亏数据
 'index_trend'  # 获取奇货可查-指数-大资金动向数据
 'fund_bs'  # 获取奇货可查-资金-净持仓分布数据
 'fund_position'  # 获取奇货可查-资金-总持仓分布数据
 'fund_position_change'  # 获取奇货可查-资金-净持仓变化分布数据
 'tool_foreign'  # 获取奇货可查-工具-外盘比价数据
 'tool_gdp'  # 获取奇货可查-工具-各地区经济数据

3. 案例演示

3. 获取展期收益率

Example 3.1 获取展期收益率数据:

代码:

import qhsdk as qh
qh.tool_gdp()

结果显示: 日期, 展期收益率, 最近合约, 下一期合约

            roll_yield near_by deferred
2018-06-19    0.191289  RB1810   RB1901
2018-06-20    0.192123  RB1810   RB1901
2018-06-21    0.183304  RB1810   RB1901
2018-06-22    0.190642  RB1810   RB1901
2018-06-25    0.194838  RB1810   RB1901
2018-06-26    0.204314  RB1810   RB1901
2018-06-27    0.213667  RB1810   RB1901
2018-06-28    0.211701  RB1810   RB1901
2018-06-29    0.205892  RB1810   RB1901
2018-07-02    0.224809  RB1810   RB1901
2018-07-03    0.229198  RB1810   RB1901
2018-07-04    0.222853  RB1810   RB1901
2018-07-05    0.247187  RB1810   RB1901
2018-07-06    0.261259  RB1810   RB1901
2018-07-09    0.253283  RB1810   RB1901
2018-07-10    0.225832  RB1810   RB1901
2018-07-11    0.210659  RB1810   RB1901
2018-07-12    0.212805  RB1810   RB1901
2018-07-13    0.170282  RB1810   RB1901
2018-07-16    0.218066  RB1810   RB1901
2018-07-17    0.229768  RB1810   RB1901
2018-07-18    0.225529  RB1810   RB1901

Anaconda安装说明及环境配置

Anaconda 安装说明

Anaconda 是集成了上千个常用库的 Python 发行版本, 通过安装 Anaconda 能简化环境管理工作, 非常推荐使用. 作者基于目前 Python2 即将停止更新, 且目前大部分使用者电脑系统基本都是 64 位, 所以建议选择 Python3.7.3 64 位版本 同时, 根据您电脑的操作系统选择相对应的版本: Windows 版, MacOS 或 Linux 版的 64 位安装包.

安装演示(以 64 位 windows 版本为例)

下图中红框为 64 位 Windows 选择的版本:

在这里, 作者建议下载 Anaconda3-2019.07, 点击下载 最新版 Anaconda 官方下载链接

双击如下图标进行安装:

点击 Next:

点击 I Agree:

点击 Just me --> Next:

修改 Destination Folder 为如图所示:

勾选下图红框选项(以便于把安装的环境加入系统路径) --> Install:

安装好后, 找到 Anaconda Prompt 窗口:

输入 python, 如果如下图所示, 即已经在系统目录中安装好 anaconda3 的环境.

创建虚拟环境命令:

conda create -n ak_test python=3.7.3

输入上述命令后出现确认, 输入 y

Proceed 输入 y

显示出最后一个红框内容则创建虚拟环境成功.

在虚拟环境中安装 qhsdk. 输入如下内容, 会在全新的环境中自动安装所需要的依赖包

激活已经创建好的 ak_test 虚拟环境

conda activate ak_test

在 ak_test 虚拟环境中安装并更新 qhsdk

pip install akshare --upgrade

在安装完毕后, 输入 python 进入虚拟环境中的 Python

python

在 ak_test 虚拟环境的 Python 环境里面输入:

import qhsdk as qh
qh.__doc__

显示出如下图则虚拟环境和 qhsdk 安装成功:

还可以在 ak_test 虚拟环境的 Python 环境中输入如下代码可以显示 qhsdk 的版本

import qhsdk as qh
qh.__version__

每日监控下载配置

本地配置好 Anaconda, 以及通过 pip 安装好 qhsdk 后, 在 github 上下载示例文件, 即按照下图选择.

https://github.com/jindaxiang/akshare

解压下载的文件, 然后来到 example 目录下, 设置 setting 配置文件 root 设置为 qhsdk 爬数据时存储的默认目录(需要保证目录存在), qqEmail 和 secret 为爬取到数据时把数据发送给自己的 qq 邮箱账号和密码. 需要开通SMTP服务, 如果不需要自己邮件提醒, 就不用设置(也不要改默认的qqEmail和secret).

最后双击 monitor.cmd 即完成, 每日 17 点自动下载数据.

QQ邮箱SMTP服务设置

在利用 Python 程序发送 QQ 邮件时, 需要开启 QQ 邮件的 SMTP 服务, 操作方法如下, 第一步打开 QQ 邮箱, 点"设置".

找到"账户", 并下拉

开启以下的两项服务, 并生成授权码, 授权码为 Python 程序通过 SMTP 发送邮件的密码, 即上一节文档的 secret(不同于QQ邮箱登录密码)

在启动服务的过程中, 如果该 QQ 账户没有绑定过手机号, 可能会需要验证, 这里不再赘述.

特别说明

致谢

特别感谢 AkShare 项目提供借鉴学习的机会;

声明

1. qhsdk 提供的数据仅供参考, 不构成任何投资建议;
2. 任何基于 qhsdk 进行研究的投资者请注意数据风险;
3. qhsdk 的使用请遵循奇货可查网站的用户协议;
4. qhsdk 使用产生的所有问题的最终解释权归奇货可查网站所有;

版本更新说明

0.0.1
发布测试版本

0.0.2
调试接口

0.0.3
增加lxml=4.4.1

0.0.4
更新说明文档