/qdii-value

估算 QDII 基金的净值

Primary LanguagePythonMIT LicenseMIT

qdii-value

License FOSSA Status

估算 QDII 基金的净值

注意

  • 未考虑汇率等因素

  • 数值仅供参考，不作为任何依据

  • 投资有风险，操作需谨慎

  • 仅供学习交流使用

介绍

  1. 通过抓取 Eastmoney/HSBC HK/Bloomberg 上基金最近的持仓报告，获取持仓前 x 股票代码

  2. 在 Investing/新浪财经/雅虎奇摩/Google Finance 上查询每只股票当前行情

注意：

  1. Investing 已屏蔽非大陆 IP 使用国内版接口，在海外部署可使用 Google Finance 数据源；
  2. 雅虎以及除日本外各分站已屏蔽大陆 IP（返回 HTTP 4xx）；
  3. Bloomberg 极易遇反爬

新浪财经支持 A/H/美股，延迟低；Investing 支持的市场范围广

可作为 package 调用，demo: telegram @ono_rin_bot

安装

Python 3.6+

# pip 直接安装
$ pip install --upgrade git+https://github.com/xiaopc/qdii-value.git#egg=qdii_value
# pip 本地开发模式
$ pip install -e .
# 使用 setuptools 安装 (develop 为本地开发模式，--record 输出文件列表)
$ python setup.py install

Windows 用户若 Python < 3.9 可能需要手动安装 backports.zoneinfo 和 tzdata

如需新浪源 A/H 股历史数据，需要手动安装 STPyV8 包（实时数据不需要）

通过 whl 安装 STPyV8 若遇到 .so 找不到等报错，则需补全系统依赖，如 libboost-all-dev libboost-system-dev libboost-filesystem-dev libboost-thread-dev 等

使用

注意：0.3.0 版本起不支持旧版配置文件

命令行界面 CLI

建议使用现代终端 (Terminal) 以获得更佳的使用体验

Windows 用户推荐 Windows Terminal

# 实时行情
$ qdii-value 基金代码 # 加参数 --csv 保存至文件
# 统计历史行情
$ qdii-value 基金代码 --history 天数
# 更多参数请参见帮助
$ qdii-value --help

作为库调用

from qdii_value.confs import Config
from qdii_value import processing

c = Config(json_conf_as_an_object)

# 多 equity 实时涨跌及其统计
equities, summary = processing.fetch(c.data['equities'])

if c.data['reference']:
    # 单 equity 实时
    reference = processing.single_fetch(c.data['reference'])

# 多 equity 历史行情
# 提示：接口定义可能在后续版本中有所变动
# 新浪源美股仅提供最近 140 天数据
history = processing.fetch_history(c.data['equities'], limit=21)
# investing 源推荐使用指定日期接口
from qdii_value.provider.equity import investing
his = investing.history(41042, 1606885171, 1608699571)

# ...