vietfin 0.2.0

VietFin

» Explore the docs »

1. Why VietFin?

Heavily inspired by OpenBB, 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. To use the package:

1. Install VietFin in your project's virtual environment.

   $ pip install vietfin
   

   Or using Poetry, my preferred dependency manager:

   $ poetry add vietfin
   

2. Import the package then use the package

   from vietfin import vf
   

Requirements:

• Python >= 3.10
• pandas >= 2.1.4
• Pydantic >= 2.5
• httpx >= 0.27
• selectolax >= 0.3
• openpyxl >= 3.1.2

3. Usage

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 and Code of Conduct.

VietFin relies on community to investigate bugs and contribute code.

Before creating a ticket, please check our Issues tracker to avoid duplicates.

• Report bug
• Suggest improvement
• Request a feature

Feel free to reach out to us in our GitHub 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, its Data Standardization Infrastructure, the hierarchical structure of user-facing commands, and the documentation style of OpenBB Platform's API reference.
• 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, or send an email to vietfin.numbness179(at)simplelogin.fr.