<p align="center">
<img src="https://github.com/vietfin/vietfin/blob/main/docs/_static/logo.jpg" alt="VietFin" width="228" />
</p>
<h2 align="center">VietFin</h2>
<div align="center">A python library to fetch Vietnam stock market data.</div>
<p align="center">
<a href="https://github.com/vietfin/vietfin/blob/main/LICENSE"><img src="https://img.shields.io/github/license/vietfin/vietfin?style=for-the-badge" alt="License" /></a>
<a href='https://vietfin.readthedocs.io/en/latest/?badge=latest'><img src='https://readthedocs.org/projects/vietfin/badge/?version=latest&style=for-the-badge' alt='Documentation Status' /></a>
<a href='https://pypi.org/project/vietfin/'><img src='https://img.shields.io/pypi/v/vietfin?style=for-the-badge' alt='PyPI - Version' /></a>
<br />
<a href="http://vietfin.readthedocs.io/" target="_blank" rel="noopener noreferrer"><strong>» Explore the docs »</strong></a>
<br />
</p>
<hr />
<!-- TABLE OF CONTENTS -->
<details closed="closed">
<summary><h2 style="display: inline-block">Table of Contents</h2></summary>
<ol>
<li><a href="#1-why-vietfin">Why VietFin?</a></li>
<li><a href="#2-isntallation">Installation</a></li>
<li><a href="#3-usage">Usage</a></li>
<li><a href="#4-contributing">Contributing</a></li>
<li><a href="#5-attributions">Attributions</a></li>
<li><a href="#6-disclaimer">Disclaimer</a></li>
<li><a href="#7-contacts">Contacts</a></li>
</ol>
</details>
## 1. Why VietFin?
Heavily inspired by [OpenBB](https://github.com/OpenBB-finance/OpenBBTerminal), VietFin is a Python package which provides a wrapper around the publicly available APIs from multiple brokerage firms.
This package aims to reproduce the hierarchical structure of commands used in OpenBB, but for Vietnamese market data.
VietFin is intended for personal use, research and educational purposes.
## 2. Installation
VietFin is available on [PyPI](https://pypi.org/project/vietfin/). To use the package:
1. Install VietFin in your project's virtual environment.
``` {.sourceCode .bash}
$ pip install vietfin
```
Or using [Poetry](https://python-poetry.org/), my preferred dependency manager:
``` {.sourceCode .bash}
$ poetry add vietfin
```
2. Import the package then use the package
``` {.sourceCode .python}
from vietfin import vf
```
Requirements:
- [Python](https://www.python.org) \>= 3.10
- [pandas](https://pandas.pydata.org/) \>= 2.1.4
- [Pydantic](https://github.com/pydantic/pydantic) \>= 2.5
- [httpx](https://www.python-httpx.org/) \>= 0.27
- [selectolax](https://github.com/rushter/selectolax) \>= 0.3
- [openpyxl](https://pypi.org/project/openpyxl/) \>= 3.1.2
## 3. Usage
```python
from vietfin import vf
# Get list of all stocks
vf.equity.search()
# Get general info of a stock
vf.equity.profile(symbol='vnm')
# Get historical price of a stock
vf.equity.historical(symbol='vnm')
# Get the historical dividends data of a company
vf.equity.fundamental.dividends(symbol='vnm')
# Get list of key executives of a company
vf.equity.fundamental.management(symbol='vnm')
# Get the key financial ratios of a company
vf.equity.fundamental.ratios(symbol='vnm')
# Get the report on the income statement of a company
vf.equity.fundamental.income(symbol='vnm')
# Get the historical events of a stock ticker
vf.equity.calendar.events(symbol='vnm')
# Get the list of available mutual funds
vf.funds.search()
# Get the list of available ETFs
vf.etf.search()
# Get the list of constituents of an index
vf.index.constituents(symbol='vn30')
# Get the list of available futures contract
vf.derivatives.futures.search()
```
## 4. Contributing
More information on our [Contributing Guidelines](/CONTRIBUTING.md) and [Code of Conduct](/CONDUCT.md).
`VietFin` relies on community to investigate bugs and contribute code.
Before creating a ticket, please check our [Issues tracker](https://github.com/vietfin/vietfin/issues) to avoid duplicates.
- [Report bug](https://github.com/vietfin/vietfin/issues/new?assignees=&labels=type%3Abug&projects=&template=bug_report.md&title=%5BBug%5D)
- [Suggest improvement](https://github.com/vietfin/vietfin/issues/new?assignees=&labels=type%3Aenhancement&projects=&template=enhancement.md&title=%5BIMPROVE%5D)
- [Request a feature](https://github.com/vietfin/vietfin/issues/new?assignees=&labels=type%3Afeature&projects=&template=feature_request.md&title=%5BFR%5D)
Feel free to reach out to us in [our GitHub Discussions](https://github.com/vietfin/vietfin/discussions) for other feedbacks (e.g. Q&A, ideas, etc.).
## 5. Attributions
VietFin is built on top of the inspiration and work of the following projects:
- [OpenBB](https://github.com/OpenBB-finance/OpenBBTerminal), its [Data Standardization Infrastructure](https://docs.openbb.co/platform/development/developer-guidelines/architectural_considerations), the hierarchical structure of user-facing commands, and the documentation style of [OpenBB Platform's API reference](https://docs.openbb.co/platform/reference).
- [vnstock](https://github.com/thinh-vu/vnstock) and its findinds on publicly available APIs from many brokerage firms in Vietnam.
## 6. Disclaimer
VietFin is not affiliated, endorsed, or vetted by any of the brokerage firms or research entities which provide the data. It's an open-source tool which fetches data from the publicly available APIs of these firms. VietFin is intended for personal use, research and educational purposes.
You should refer to each of the data provider's terms of use for details on your rights to use the actual data downloaded.
The data retrieved by the VietFin package is not necessarily accurate.
VietFin and any provider of the data contained in this website will not accept liability for any loss or damage as a result of your trading, or your reliance on the information displayed.
## 7. Contacts
If you have any questions about `VietFin` or just to say hi, feel free to [open a new public discussion in our GitHub repo](https://github.com/vietfin/vietfin/discussions/new/choose), or send an email to `vietfin.numbness179(at)simplelogin.fr`.
Raw data
{
"_id": null,
"home_page": "https://github.com/vietfin/vietfin",
"name": "vietfin",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "vietnam, stock, market, data, finance, etf, investment, funds",
"author": "Huy",
"author_email": "vietfin.numbness179@simplelogin.fr",
"download_url": "https://files.pythonhosted.org/packages/d6/8c/430b17496458bbbf0dd335ab460c8fb1ffa8b4c8037dcfca1e4c6854721a/vietfin-0.2.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"https://github.com/vietfin/vietfin/blob/main/docs/_static/logo.jpg\" alt=\"VietFin\" width=\"228\" />\n</p>\n\n<h2 align=\"center\">VietFin</h2>\n\n<div align=\"center\">A python library to fetch Vietnam stock market data.</div>\n\n<p align=\"center\">\n <a href=\"https://github.com/vietfin/vietfin/blob/main/LICENSE\"><img src=\"https://img.shields.io/github/license/vietfin/vietfin?style=for-the-badge\" alt=\"License\" /></a>\n <a href='https://vietfin.readthedocs.io/en/latest/?badge=latest'><img src='https://readthedocs.org/projects/vietfin/badge/?version=latest&style=for-the-badge' alt='Documentation Status' /></a>\n <a href='https://pypi.org/project/vietfin/'><img src='https://img.shields.io/pypi/v/vietfin?style=for-the-badge' alt='PyPI - Version' /></a>\n <br />\n <a href=\"http://vietfin.readthedocs.io/\" target=\"_blank\" rel=\"noopener noreferrer\"><strong>\u00bb Explore the docs \u00bb</strong></a>\n <br />\n</p>\n\n<hr />\n\n<!-- TABLE OF CONTENTS -->\n<details closed=\"closed\">\n <summary><h2 style=\"display: inline-block\">Table of Contents</h2></summary>\n <ol>\n <li><a href=\"#1-why-vietfin\">Why VietFin?</a></li>\n <li><a href=\"#2-isntallation\">Installation</a></li>\n <li><a href=\"#3-usage\">Usage</a></li>\n <li><a href=\"#4-contributing\">Contributing</a></li>\n <li><a href=\"#5-attributions\">Attributions</a></li>\n <li><a href=\"#6-disclaimer\">Disclaimer</a></li>\n <li><a href=\"#7-contacts\">Contacts</a></li>\n </ol>\n</details>\n\n## 1. Why VietFin?\n\nHeavily inspired by [OpenBB](https://github.com/OpenBB-finance/OpenBBTerminal), VietFin is a Python package which provides a wrapper around the publicly available APIs from multiple brokerage firms.\n\nThis package aims to reproduce the hierarchical structure of commands used in OpenBB, but for Vietnamese market data.\n\nVietFin is intended for personal use, research and educational purposes.\n\n## 2. Installation\n\nVietFin is available on [PyPI](https://pypi.org/project/vietfin/). To use the package:\n\n1. Install VietFin in your project's virtual environment.\n\n ``` {.sourceCode .bash}\n $ pip install vietfin\n ```\n\n Or using [Poetry](https://python-poetry.org/), my preferred dependency manager:\n\n ``` {.sourceCode .bash}\n $ poetry add vietfin\n ```\n\n2. Import the package then use the package\n\n ``` {.sourceCode .python}\n from vietfin import vf\n ```\n\nRequirements:\n\n- [Python](https://www.python.org) \\>= 3.10\n- [pandas](https://pandas.pydata.org/) \\>= 2.1.4\n- [Pydantic](https://github.com/pydantic/pydantic) \\>= 2.5\n- [httpx](https://www.python-httpx.org/) \\>= 0.27\n- [selectolax](https://github.com/rushter/selectolax) \\>= 0.3\n- [openpyxl](https://pypi.org/project/openpyxl/) \\>= 3.1.2\n\n## 3. Usage\n\n```python\nfrom vietfin import vf\n# Get list of all stocks\nvf.equity.search()\n\n# Get general info of a stock\nvf.equity.profile(symbol='vnm')\n\n# Get historical price of a stock\nvf.equity.historical(symbol='vnm')\n\n# Get the historical dividends data of a company\nvf.equity.fundamental.dividends(symbol='vnm')\n\n# Get list of key executives of a company\nvf.equity.fundamental.management(symbol='vnm')\n\n# Get the key financial ratios of a company\nvf.equity.fundamental.ratios(symbol='vnm')\n\n# Get the report on the income statement of a company\nvf.equity.fundamental.income(symbol='vnm')\n\n# Get the historical events of a stock ticker\nvf.equity.calendar.events(symbol='vnm')\n\n# Get the list of available mutual funds\nvf.funds.search()\n\n# Get the list of available ETFs\nvf.etf.search()\n\n# Get the list of constituents of an index\nvf.index.constituents(symbol='vn30')\n\n# Get the list of available futures contract\nvf.derivatives.futures.search()\n```\n\n## 4. Contributing\n\nMore information on our [Contributing Guidelines](/CONTRIBUTING.md) and [Code of Conduct](/CONDUCT.md).\n\n`VietFin` relies on community to investigate bugs and contribute code.\n\nBefore creating a ticket, please check our [Issues tracker](https://github.com/vietfin/vietfin/issues) to avoid duplicates.\n\n- [Report bug](https://github.com/vietfin/vietfin/issues/new?assignees=&labels=type%3Abug&projects=&template=bug_report.md&title=%5BBug%5D)\n- [Suggest improvement](https://github.com/vietfin/vietfin/issues/new?assignees=&labels=type%3Aenhancement&projects=&template=enhancement.md&title=%5BIMPROVE%5D)\n- [Request a feature](https://github.com/vietfin/vietfin/issues/new?assignees=&labels=type%3Afeature&projects=&template=feature_request.md&title=%5BFR%5D)\n\nFeel free to reach out to us in [our GitHub Discussions](https://github.com/vietfin/vietfin/discussions) for other feedbacks (e.g. Q&A, ideas, etc.).\n\n## 5. Attributions\n\nVietFin is built on top of the inspiration and work of the following projects:\n\n- [OpenBB](https://github.com/OpenBB-finance/OpenBBTerminal), its [Data Standardization Infrastructure](https://docs.openbb.co/platform/development/developer-guidelines/architectural_considerations), the hierarchical structure of user-facing commands, and the documentation style of [OpenBB Platform's API reference](https://docs.openbb.co/platform/reference).\n- [vnstock](https://github.com/thinh-vu/vnstock) and its findinds on publicly available APIs from many brokerage firms in Vietnam.\n\n## 6. Disclaimer\n\nVietFin is not affiliated, endorsed, or vetted by any of the brokerage firms or research entities which provide the data. It's an open-source tool which fetches data from the publicly available APIs of these firms. VietFin is intended for personal use, research and educational purposes.\n\nYou should refer to each of the data provider's terms of use for details on your rights to use the actual data downloaded.\n\nThe data retrieved by the VietFin package is not necessarily accurate.\n\nVietFin and any provider of the data contained in this website will not accept liability for any loss or damage as a result of your trading, or your reliance on the information displayed.\n\n## 7. Contacts\n\nIf you have any questions about `VietFin` or just to say hi, feel free to [open a new public discussion in our GitHub repo](https://github.com/vietfin/vietfin/discussions/new/choose), or send an email to `vietfin.numbness179(at)simplelogin.fr`.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python package to fetch Vietnam stock market data",
"version": "0.2.0",
"project_urls": {
"Documentation": "https://github.com/vietfin/vietfin",
"Homepage": "https://github.com/vietfin/vietfin",
"Repository": "https://github.com/vietfin/vietfin"
},
"split_keywords": [
"vietnam",
" stock",
" market",
" data",
" finance",
" etf",
" investment",
" funds"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a46ba323d6962262d7f72a331d79e9838ff750a6dcf8a16f3869ca95fa0218c1",
"md5": "bed3be6f90ba85493fa6835f6e7b7661",
"sha256": "ae1fb8418a09c2afbbe3f7b957b49e13cb9f826e94b856666c56cb5d83505fa4"
},
"downloads": -1,
"filename": "vietfin-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bed3be6f90ba85493fa6835f6e7b7661",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 112204,
"upload_time": "2024-04-22T00:20:05",
"upload_time_iso_8601": "2024-04-22T00:20:05.827201Z",
"url": "https://files.pythonhosted.org/packages/a4/6b/a323d6962262d7f72a331d79e9838ff750a6dcf8a16f3869ca95fa0218c1/vietfin-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d68c430b17496458bbbf0dd335ab460c8fb1ffa8b4c8037dcfca1e4c6854721a",
"md5": "ed7f2a180f7e98cb30ccb90008eefa2e",
"sha256": "ce16ee202603fd9ab167bf89f772a42e4abc913812977da4cb5ec4a043fc8691"
},
"downloads": -1,
"filename": "vietfin-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "ed7f2a180f7e98cb30ccb90008eefa2e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 58288,
"upload_time": "2024-04-22T00:20:07",
"upload_time_iso_8601": "2024-04-22T00:20:07.774566Z",
"url": "https://files.pythonhosted.org/packages/d6/8c/430b17496458bbbf0dd335ab460c8fb1ffa8b4c8037dcfca1e4c6854721a/vietfin-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-22 00:20:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vietfin",
"github_project": "vietfin",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "vietfin"
}
JSON
