# [qhsdk](https://pypi.org/project/qhsdk/)
## [qhsdk](https://pypi.org/project/qhsdk/) 的介绍
[qhsdk](https://pypi.org/project/qhsdk/) 主要是为 **https://qhkch.com/** 提供 SDK 的 Python 库, 您可以通过 [奇货可查机构VIP接口文档](https://www.showdoc.cc/qhkchapi?page_id=3878436763477725) 了解和查询详细数据接口！
## [qhsdk](https://pypi.org/project/qhsdk/) 服务于 **www.qhkch.com**
<img src="https://static.qhkch.com/dist//style/res/logo.png" align = center/>
## [qhsdk](https://pypi.org/project/qhsdk/) 的特色
[qhsdk](https://pypi.org/project/qhsdk/) 主要改进如下:
1. [qhsdk](https://pypi.org/project/qhsdk/)支持 **Python 3.7** 及以上版本;
2. 目前提供已提供奇货可查全部接口;
3. 提供完善的接口文档, 提高 [qhsdk](https://pypi.org/project/qhsdk/) 的易用性;
# 安装方法
```
pip install qhsdk
```
# 升级方法
```
pip install qhsdk --upgrade
```
# 快速入门
目标数据: 奇货可查-商品-持仓数据接口
示例代码:
```python
import qhsdk as qh
pro = qh.pro_api(token="此处输入您的token, 请联系奇货可查获取！")
variety_positions_df = pro.variety_positions(fields="shorts", code="rb1810", date="2018-08-08")
print(variety_positions_df)
```
示例结果:
```
broker short short_chge
0 银河期货 60987 -4228
1 永安期货 57520 -1071
2 中信期货 38120 -620
3 国泰君安 36498 528
4 方正中期 32105 4444
5 海通期货 29638 -2783
6 东海期货 29250 450
7 光大期货 28458 -84
8 南华期货 27853 -144
9 中辉期货 26101 -553
10 中大期货 23761 1572
11 鲁证期货 22501 -598
12 兴证期货 22262 -842
13 东证期货 21675 -686
14 徽商期货 18966 -607
15 中信建投 18583 -625
16 华泰期货 17076 -5797
17 国投安信 16808 349
18 申银万国 14876 376
19 广发期货 14588 -2196
20 大地期货 0 -14603
```
# 特别说明
## 致谢
特别感谢 [AkShare](https://github.com/jindaxiang/akshare) 项目提供借鉴学习的机会;
## 声明
1. [qhsdk](https://pypi.org/project/qhsdk) 提供的数据仅供参考, 不构成任何投资建议;
2. 任何基于 [qhsdk](https://pypi.org/project/qhsdk) 进行研究的投资者请注意数据风险;
3. [qhsdk](https://pypi.org/project/qhsdk) 的使用请遵循奇货可查网站的用户协议;
4. [qhsdk](https://pypi.org/project/qhsdk) 使用产生的所有问题的最终解释权归奇货可查网站所有;
# 版本更新说明
```
0.0.1
发布测试版本
0.0.2
调试接口
0.0.3
增加lxml=4.4.1
0.0.4
更新说明文档
0.0.5
新增通过用户名和密码登录并访问VIP资源功能
0.0.6
修正导入问题
0.0.7
更新 README 文档
0.0.8
第二版接口测试
0.0.9
更新说明文档
0.1.0
更新测试文件
0.1.1
预览版
0.1.2
增加 token 使用说明
0.1.3
增加 inventory 参数类型二
0.1.4
新增: 合约持仓数据接口, 商品持仓数据接口, 修复部分接口与文档一致
0.1.5
新增: 增加 broker_positions_process 中 start_date 和 end_date 可选参数
0.1.6
新增: 增加 variety_calc_positions 接口
0.1.7
修改: 修改 variety_all 接口, 新增 3 个字段
0.1.8
新增: 新增 variety_net_position_list 接口
0.1.9
新增: 同步文档 2021年11月25日 版本
0.1.10
新增: inventory_new 接口
修复：返回空值
0.1.11
修复: 修改 url 地址
```
# 文档构建
```shell
cd docs
```
```shell
pip install -r requirements.txt
```
```shell
sphinx-build -b html . _build
```
Raw data
{
"_id": null,
"home_page": "https://github.com/jindaxiang/qhsdk",
"name": "qhsdk",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "futures finance sdk",
"author": "qhkch",
"author_email": "jindaxiang@163.com",
"download_url": "https://files.pythonhosted.org/packages/5c/20/ad9912b50b563a6abf0e42547ed1b7d1631aad2920f3f189d4f80657fa13/qhsdk-0.1.11.tar.gz",
"platform": null,
"description": "# [qhsdk](https://pypi.org/project/qhsdk/)\r\n\r\n## [qhsdk](https://pypi.org/project/qhsdk/) \u7684\u4ecb\u7ecd\r\n\r\n[qhsdk](https://pypi.org/project/qhsdk/) \u4e3b\u8981\u662f\u4e3a **https://qhkch.com/** \u63d0\u4f9b SDK \u7684 Python \u5e93, \u60a8\u53ef\u4ee5\u901a\u8fc7 [\u5947\u8d27\u53ef\u67e5\u673a\u6784VIP\u63a5\u53e3\u6587\u6863](https://www.showdoc.cc/qhkchapi?page_id=3878436763477725) \u4e86\u89e3\u548c\u67e5\u8be2\u8be6\u7ec6\u6570\u636e\u63a5\u53e3\uff01\r\n\r\n## [qhsdk](https://pypi.org/project/qhsdk/) \u670d\u52a1\u4e8e **www.qhkch.com**\r\n\r\n<img src=\"https://static.qhkch.com/dist//style/res/logo.png\" align = center/>\r\n\r\n## [qhsdk](https://pypi.org/project/qhsdk/) \u7684\u7279\u8272\r\n\r\n[qhsdk](https://pypi.org/project/qhsdk/) \u4e3b\u8981\u6539\u8fdb\u5982\u4e0b:\r\n\r\n1. [qhsdk](https://pypi.org/project/qhsdk/)\u652f\u6301 **Python 3.7** \u53ca\u4ee5\u4e0a\u7248\u672c;\r\n2. \u76ee\u524d\u63d0\u4f9b\u5df2\u63d0\u4f9b\u5947\u8d27\u53ef\u67e5\u5168\u90e8\u63a5\u53e3;\r\n3. \u63d0\u4f9b\u5b8c\u5584\u7684\u63a5\u53e3\u6587\u6863, \u63d0\u9ad8 [qhsdk](https://pypi.org/project/qhsdk/) \u7684\u6613\u7528\u6027;\r\n\r\n# \u5b89\u88c5\u65b9\u6cd5\r\n\r\n```\r\npip install qhsdk\r\n```\r\n\r\n# \u5347\u7ea7\u65b9\u6cd5\r\n\r\n```\r\npip install qhsdk --upgrade\r\n```\r\n\r\n# \u5feb\u901f\u5165\u95e8\r\n\r\n\u76ee\u6807\u6570\u636e: \u5947\u8d27\u53ef\u67e5-\u5546\u54c1-\u6301\u4ed3\u6570\u636e\u63a5\u53e3\r\n\r\n\u793a\u4f8b\u4ee3\u7801:\r\n\r\n```python\r\nimport qhsdk as qh\r\n\r\npro = qh.pro_api(token=\"\u6b64\u5904\u8f93\u5165\u60a8\u7684token, \u8bf7\u8054\u7cfb\u5947\u8d27\u53ef\u67e5\u83b7\u53d6\uff01\")\r\n\r\nvariety_positions_df = pro.variety_positions(fields=\"shorts\", code=\"rb1810\", date=\"2018-08-08\")\r\nprint(variety_positions_df)\r\n```\r\n\r\n\u793a\u4f8b\u7ed3\u679c:\r\n\r\n```\r\n broker short short_chge\r\n0 \u94f6\u6cb3\u671f\u8d27 60987 -4228\r\n1 \u6c38\u5b89\u671f\u8d27 57520 -1071\r\n2 \u4e2d\u4fe1\u671f\u8d27 38120 -620\r\n3 \u56fd\u6cf0\u541b\u5b89 36498 528\r\n4 \u65b9\u6b63\u4e2d\u671f 32105 4444\r\n5 \u6d77\u901a\u671f\u8d27 29638 -2783\r\n6 \u4e1c\u6d77\u671f\u8d27 29250 450\r\n7 \u5149\u5927\u671f\u8d27 28458 -84\r\n8 \u5357\u534e\u671f\u8d27 27853 -144\r\n9 \u4e2d\u8f89\u671f\u8d27 26101 -553\r\n10 \u4e2d\u5927\u671f\u8d27 23761 1572\r\n11 \u9c81\u8bc1\u671f\u8d27 22501 -598\r\n12 \u5174\u8bc1\u671f\u8d27 22262 -842\r\n13 \u4e1c\u8bc1\u671f\u8d27 21675 -686\r\n14 \u5fbd\u5546\u671f\u8d27 18966 -607\r\n15 \u4e2d\u4fe1\u5efa\u6295 18583 -625\r\n16 \u534e\u6cf0\u671f\u8d27 17076 -5797\r\n17 \u56fd\u6295\u5b89\u4fe1 16808 349\r\n18 \u7533\u94f6\u4e07\u56fd 14876 376\r\n19 \u5e7f\u53d1\u671f\u8d27 14588 -2196\r\n20 \u5927\u5730\u671f\u8d27 0 -14603\r\n```\r\n\r\n# \u7279\u522b\u8bf4\u660e\r\n\r\n## \u81f4\u8c22\r\n\r\n\u7279\u522b\u611f\u8c22 [AkShare](https://github.com/jindaxiang/akshare) \u9879\u76ee\u63d0\u4f9b\u501f\u9274\u5b66\u4e60\u7684\u673a\u4f1a;\r\n\r\n## \u58f0\u660e\r\n\r\n1. [qhsdk](https://pypi.org/project/qhsdk) \u63d0\u4f9b\u7684\u6570\u636e\u4ec5\u4f9b\u53c2\u8003, \u4e0d\u6784\u6210\u4efb\u4f55\u6295\u8d44\u5efa\u8bae;\r\n2. \u4efb\u4f55\u57fa\u4e8e [qhsdk](https://pypi.org/project/qhsdk) \u8fdb\u884c\u7814\u7a76\u7684\u6295\u8d44\u8005\u8bf7\u6ce8\u610f\u6570\u636e\u98ce\u9669;\r\n3. [qhsdk](https://pypi.org/project/qhsdk) \u7684\u4f7f\u7528\u8bf7\u9075\u5faa\u5947\u8d27\u53ef\u67e5\u7f51\u7ad9\u7684\u7528\u6237\u534f\u8bae;\r\n4. [qhsdk](https://pypi.org/project/qhsdk) \u4f7f\u7528\u4ea7\u751f\u7684\u6240\u6709\u95ee\u9898\u7684\u6700\u7ec8\u89e3\u91ca\u6743\u5f52\u5947\u8d27\u53ef\u67e5\u7f51\u7ad9\u6240\u6709;\r\n\r\n# \u7248\u672c\u66f4\u65b0\u8bf4\u660e\r\n```\r\n0.0.1\r\n\u53d1\u5e03\u6d4b\u8bd5\u7248\u672c\r\n\r\n0.0.2\r\n\u8c03\u8bd5\u63a5\u53e3\r\n\r\n0.0.3\r\n\u589e\u52a0lxml=4.4.1\r\n\r\n0.0.4\r\n\u66f4\u65b0\u8bf4\u660e\u6587\u6863\r\n\r\n0.0.5\r\n\u65b0\u589e\u901a\u8fc7\u7528\u6237\u540d\u548c\u5bc6\u7801\u767b\u5f55\u5e76\u8bbf\u95eeVIP\u8d44\u6e90\u529f\u80fd\r\n\r\n0.0.6\r\n\u4fee\u6b63\u5bfc\u5165\u95ee\u9898\r\n\r\n0.0.7\r\n\u66f4\u65b0 README \u6587\u6863\r\n\r\n0.0.8\r\n\u7b2c\u4e8c\u7248\u63a5\u53e3\u6d4b\u8bd5\r\n\r\n0.0.9\r\n\u66f4\u65b0\u8bf4\u660e\u6587\u6863\r\n\r\n0.1.0\r\n\u66f4\u65b0\u6d4b\u8bd5\u6587\u4ef6\r\n\r\n0.1.1\r\n\u9884\u89c8\u7248\r\n\r\n0.1.2\r\n\u589e\u52a0 token \u4f7f\u7528\u8bf4\u660e\r\n\r\n0.1.3\r\n\u589e\u52a0 inventory \u53c2\u6570\u7c7b\u578b\u4e8c\r\n\r\n0.1.4\r\n\u65b0\u589e: \u5408\u7ea6\u6301\u4ed3\u6570\u636e\u63a5\u53e3, \u5546\u54c1\u6301\u4ed3\u6570\u636e\u63a5\u53e3, \u4fee\u590d\u90e8\u5206\u63a5\u53e3\u4e0e\u6587\u6863\u4e00\u81f4\r\n\r\n0.1.5\r\n\u65b0\u589e: \u589e\u52a0 broker_positions_process \u4e2d start_date \u548c end_date \u53ef\u9009\u53c2\u6570\r\n\r\n0.1.6\r\n\u65b0\u589e: \u589e\u52a0 variety_calc_positions \u63a5\u53e3\r\n\r\n0.1.7\r\n\u4fee\u6539: \u4fee\u6539 variety_all \u63a5\u53e3, \u65b0\u589e 3 \u4e2a\u5b57\u6bb5\r\n\r\n0.1.8\r\n\u65b0\u589e: \u65b0\u589e variety_net_position_list \u63a5\u53e3\r\n\r\n0.1.9\r\n\u65b0\u589e: \u540c\u6b65\u6587\u6863 2021\u5e7411\u670825\u65e5 \u7248\u672c\r\n\r\n0.1.10\r\n\u65b0\u589e: inventory_new \u63a5\u53e3\r\n\u4fee\u590d\uff1a\u8fd4\u56de\u7a7a\u503c\r\n\r\n0.1.11\r\n\u4fee\u590d: \u4fee\u6539 url \u5730\u5740\r\n```\r\n\r\n# \u6587\u6863\u6784\u5efa\r\n\r\n```shell\r\ncd docs\r\n```\r\n\r\n```shell\r\npip install -r requirements.txt\r\n```\r\n\r\n```shell\r\nsphinx-build -b html . _build\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python SDK for www.qhkch.com!",
"version": "0.1.11",
"split_keywords": [
"futures",
"finance",
"sdk"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5c20ad9912b50b563a6abf0e42547ed1b7d1631aad2920f3f189d4f80657fa13",
"md5": "a2007469e754c8895ecea2887617afed",
"sha256": "a5c089f8d995df01e153e35ee7da57a4d9ed3994f54977c29cbfb94d35bb78f4"
},
"downloads": -1,
"filename": "qhsdk-0.1.11.tar.gz",
"has_sig": false,
"md5_digest": "a2007469e754c8895ecea2887617afed",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 10683,
"upload_time": "2023-04-03T13:27:58",
"upload_time_iso_8601": "2023-04-03T13:27:58.845643Z",
"url": "https://files.pythonhosted.org/packages/5c/20/ad9912b50b563a6abf0e42547ed1b7d1631aad2920f3f189d4f80657fa13/qhsdk-0.1.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-03 13:27:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "jindaxiang",
"github_project": "qhsdk",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "qhsdk"
}
JSON
