https://github.com/ruioaix/snowman
Interactive system for portfolios on xueqiu.com
https://github.com/ruioaix/snowman
interaction portfolio stock-trading xueqiu
Last synced: about 2 months ago
JSON representation
Interactive system for portfolios on xueqiu.com
- Host: GitHub
- URL: https://github.com/ruioaix/snowman
- Owner: ruioaix
- License: mit
- Created: 2017-06-27T22:34:08.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-07-09T18:47:42.000Z (over 8 years ago)
- Last Synced: 2025-07-06T00:53:57.631Z (8 months ago)
- Topics: interaction, portfolio, stock-trading, xueqiu
- Language: Python
- Size: 59.6 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Changelog: HISTORY.rst
- License: LICENSE
Awesome Lists containing this project
README
Snowman: Play Snowball
======================
.. image:: https://readthedocs.org/projects/snowman/badge/?version=latest
:target: http://snowman.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://img.shields.io/pypi/v/snowman.svg
:target: https://pypi.python.org/pypi/snowman
:alt: PyPI: the Python Package Index
.. image:: https://img.shields.io/travis/ruioaix/snowman/master.svg
:target: https://travis-ci.org/ruioaix/snowman
:alt: Travis CI: continuous integration status
.. image:: https://img.shields.io/pypi/l/snowman.svg
:target: https://pypi.python.org/pypi/snowman
.. image:: https://img.shields.io/pypi/pyversions/snowman.svg
:target: https://pypi.python.org/pypi/snowman
Snowman is an interactive system for portfolios on xueqiu.com, including a library and a simple command line tool.
Simple example of Snowman tool:
.. code-block:: sh
>>> snowman info ZH123456
{'symbol': 'ZH123456', 'name': '绝代双骄', 'market': 'cn', 'status': 'active', 'created': '2015.01.07', 'updated_at': '2017-05-11 04:04:13', 'net_value': 1.3235, 'follower_count': 1}
>>> snowman owner ZH123456
{'id': 2246830809, 'screen_name': '小目学秀荣', 'description': '长期关注同仁堂，茅台。自认是价值投资的学习者。', 'followers_count': 19, 'friends_count': 179, 'status_count': 97}
Simple example of Snowman library:
.. code-block:: python
>>> from snowman import Info
>>> info = Info('ZH123456')
>>> info.get()
{'symbol': 'ZH123456', 'name': '绝代双骄', 'market': 'cn', 'status': 'active', 'created': '2015.01.07', 'updated_at': '2017-05-11 04:04:13', 'net_value': 1.3235, 'follower_count': 1}
>>> info.owner()
{'id': 2246830809, 'screen_name': '小目学秀荣', 'description': '长期关注同仁堂，茅台。自认是价值投资的学习者。', 'followers_count': 19, 'friends_count': 179, 'status_count': 97}
>>>from snowman import Analysis
>>>ana = Analysis('ZH123456')
>>>ana.turnover()
0.003
>>>ana.topstocks()
[{'symbol': 'SH601009', 'name': '南京银行', 'benefit': 0.17390683596197054, 'holding_duration': 911}, {'symbol': 'SZ000895', 'name': '双汇发展', 'benefit': 0.16364759739488366, 'holding_duration': 911}]
Snowman allows you to get most of the information of the portfolios on `xueqiu.com `_ website.
Feature Support
---------------
Snowman supports Python 3.3-3.6.
Snowman supports following query functionalities:
- basic information, including name, owner, creation date, current holding and so on.
- analysis data, including turnover, liquidity and so on.
- profit history
- rebalancing history
Installation
____________
To install Snowman, simply
.. code-block:: bash
$ pip install snowman
Documentation
-------------
Documentation is available at http://snowman.readthedocs.io
TODO
----
- portfolio-rebalancing functionality.