vnstock3 3.2.1

A comprehensive and transparent solution for Vietnamese stock market analysis.

Vnstock3 - Giải pháp phân tích chứng khoán mở cho người Việt

---

I. 🎤 Giới thiệu

Hiện tại Vnstock3 đã được hợp nhất với Vnstock, bạn vui lòng cài đặt phiên bản thư viện mới nhất với tên gọi vnstock. Thư viện với tên gọi vnstock3 sẽ không được cập nhật thêm.

Vnstock3 là phiên bản phần mềm Vnstock thế hệ thứ 3 được giới thiệu công khai vào 10/5/2024. Đây là thế hệ Vnstock với nhiều nâng cấp giá trị, chia sẻ tầm nhìn rõ ràng hơn về Vnstock với vai trò một giải pháp phân tích thị trường chứng khoán mã nguồn mở mang nhiều dấu ấn của tương lai công nghệ.

Vnstock sẽ luôn là giải pháp miễn phí để bạn tiếp cận dữ liệu chứng khoán, tài chính toàn diện, miễn phí với các nhu cầu thiết yếu và làm quen với bộ giải pháp Python linh hoạt. Chúc mừng bạn là một phần của sự thay đổi trong hành trình chuyển đổi số thị trường chứng khoán tại Việt Nam.

Tham gia cộng đồng Vnstock để chia sẻ, thảo luận và giao lưu cùng chúng tôi!

II. Tính năng nổi bật

Vnstock3 cung cấp bộ dữ liệu phong phú cho nhà đầu tư, nhà phân tích và nhà nghiên cứu tài chính, giúp tiếp cận thị trường Việt Nam & Thế Giới một cách toàn diện và nhanh chóng:

1. Dữ liệu cổ phiếu: Giá thời gian thực, lịch sử và các chỉ số tài chính của cổ phiếu niêm yết.
2. Chỉ số Index: Theo dõi hiệu suất các chỉ số chính của thị trường.
3. Chứng quyền: Thông tin giá cả, ngày đáo hạn và nhà phát hành.
4. Kim loại quý: Dữ liệu giá vàng.
5. Hợp đồng tương lai: Giá và thông tin về hợp đồng tương lai.
6. Quỹ đầu tư: Thông tin quỹ mở, ETF và các quỹ đầu tư khác.
7. Trái phiếu: Thông tin & dữ liệu giao dịch Trái phiếu chính phủ, doanh nghiệp.
8. Forex: Tỷ giá ngoại hối theo thời gian thực.
9. Crypto: Giá cả và giao dịch tiền điện tử.
10. Tin tức & sự kiện: Cập nhật tin tức tài chính và các sự kiện quan trọng.

III. ⏱️ Cập nhật đáng chú ý

• 20-03-2025: Ra mắt phiên bản Vnstock 3.2.0 bổ sung thêm tính năng truy xuất dữ liệu Bộ lọc cổ phiếu.
• 02-01-2025: Vnstock3 chính thức sử dụng tên nhận diện gói thư viện là vnstock tại trang phân phối chính thức pypi.org. Chi tiết tại đây
• 02-11-2024: Ra mắt Vnstock3 phiên bản 3.0.9. Chi tiết: tại đây
• 10-05-2024: Ra mắt phiên bản Vnstock 3.0.1 với tên gói cài đặt vnstock3

Chi tiết cập nhật phần mềm và phiên bản tại đây

IV. 📔 Tài liệu hướng dẫn

Trước khi bắt đầu, hãy đánh dấu yêu thích để giúp dự án có thể tiếp cận tới nhiều người hơn. Cám ơn bạn!

Để hiểu rõ hơn về vnstock và hướng dẫn sử dụng toàn diện, bạn có thể truy cập vnstocks.com.

Xem minh hoạ các tính năng thông qua Colab Notebook sau:

4.1. Cài đặt

Bạn có thể cài đặt thư viện với câu lệnh sau:

pip install -U vnstock

4.2. Nạp thư viện

Bạn cần nạp thư viện vào môi trường Python thông qua giao diện Jupyter Notebook hoặc Terminal để có thể gọi và sử dụng các hàm được cung cấp.

Có 4 cách nạp thư viện vào môi trường làm việc như sau:

4.2.1. Nạp thông qua giao diện làm việc chính

Giao diện làm việc chính cho phép chuyển đổi nguồn và chỉ cần khai báo tên mã khi khởi động. Cấu trúc này phù hợp khi phân tích xuyên suốt 1 mã chứng khoán và nguồn dữ liệu đồng thời giúp tăng độ ổn định của mã nguồn trong tương lai khi các nguồn dữ mới được bổ sung hoặc nguồn cũ hết hiệu lực, bạn chỉ cần đổi tên nguồn để tiếp tục sử dụng.

from vnstock import Vnstock
stock = Vnstock().stock(symbol='VCI', source='VCI')
stock.quote.history(start='2020-01-01', end='2024-05-25')

4.2.2. Nạp thông qua các class tổng hợp

Bạn chọn nạp một trong các lớp chức năng chính. Các lớp chức năng này cho phép chuyển đổi dễ dàng nguồn dữ liệu được hỗ trợ trong khi giữ nguyên cấu trúc hàm. Cấu trúc này giúp tăng độ ổn định của mã nguồn trong tương lai khi các nguồn dữ mới được bổ sung hoặc nguồn cũ hết hiệu lực, bạn chỉ cần đổi tên nguồn để tiếp tục sử dụng.

from vnstock import Listing, Quote, Company, Finance, Trading, Screener 

4.2.3. Nạp các lớp tính năng riêng lẻ theo nguồn dữ liệu cố định

Bạn cần tham khảo mã nguồn để sử dụng đúng các chức năng có sẵn trong thư viện.

from vnstock.explorer.vci import Listing, Quote, Company, Finance, Trading

hoặc

from vnstock.explorer.tcbs import Listing, Quote, Company, Finance, Trading, Screener

4.3. Danh sách niêm yết

Danh sách các mã chứng khoán sử dụng trong việc thiết lập vòng lặp truy xuất dữ liệu từ các chức năng khác như Giá lịch sử, Thông tin công ty, Báo cáo tài chính, vv

from vnstock import Listing
listing = Listing()
listing.all_symbols()

4.4. Giá lịch sử & thống kê giao dịch

Giá lịch sử

from vnstock import Vnstock
stock = Vnstock().stock(symbol='ACB', source='VCI')
stock.quote.history(start='2024-01-01', end='2025-03-19', interval='1D')

hoặc

from vnstock import Quote
quote = Quote(symbol='ACB', source='VCI')
quote.history(start='2024-01-01', end='2025-03-19', interval='1D')

4.5. Intraday

Dữ liệu giao dịch khớp lệnh theo từng tick

stock.quote.intraday(symbol='ACB', page_size=10_000, show_log=False)

Chi tiết vui lòng tham khảo tài liệu và Demo Notebook.

5.6. Bảng giá giao dịch

from vnstock import Trading
Trading(source='VCI').price_board(['VCB','ACB','TCB','BID'])

4.7. Truy xuất thông tin công ty

from vnstock import Vnstock
company = Vnstock().stock(symbol='ACB', source='VCI').company
company.overview()

hoặc

from vnstock import Company
company = Company(symbol='ACB', source='VCI')
company.overview()

4.8. Truy xuất báo cáo tài chính

from vnstock import Vnstock
stock = Vnstock().stock(symbol='VCI', source='VCI')
# Bảng cân đối kế toán - năm
stock.finance.balance_sheet(period='year', lang='vi', dropna=True)
# Bảng cân đối kế toán - quý
stock.finance.balance_sheet(period='quarter', lang='en', dropna=True)
# Kết quả hoạt động kinh doanh
stock.finance.income_statement(period='year', lang='vi', dropna=True)
# Lưu chuyển tiền tệ
stock.finance.cash_flow(period='year', dropna=True)
# Chỉ số tài chính
stock.finance.ratio(period='year', lang='vi', dropna=True)

4.9. Bộ lọc cổ phiếu

from vnstock import Screener
stock.screener.stock(params={"exchangeName": "HOSE,HNX,UPCOM"}, limit=1700)

4.10. Dữ liệu quỹ mở

from vnstock.explorer.fmarket.fund import Fund
fund = Fund()
fund.listing()

4.11. Dữ liệu thị trường quốc tế: Cổ phiếu, FX, Index

from vnstock import Vnstock
fx = Vnstock().fx(symbol='JPYVND', source='MSN')
df = fx.quote.history(start='2025-01-02', end='2025-03-20', interval='1D')
df

4.12. Tỷ giá & giá vàng

from vnstock.explorer.misc import *

# Tỷ giá ngoại tệ VCB
vcb_exchange_rate(date='2024-03-21')

# Giá vàng SJC
sjc_gold_price()

4.13. Xuất dữ liệu

Tất cả dữ liệu trả về từ Vnstock đều là Pandas DataFrame hoặc Series, do đó, bạn có thể mô hình hoá các thao tác phân tích của mình với lệnh Python dễ dàng nhờ hỗ trợ của AI. Nếu cần xuất dữ liệu sang các định dạng truyền thống, bạn chỉ cần gán các hàm mô tả ở trên với 1 tên biến và thực hiện xuất dữ liệu như dưới đây:

# Biến ratio_df lưu giá trị của phép tính vào bộ nhớ
ratio_df = stock.finance.ratio(period='year', lang='vi', dropna=True)

# Xuất dữ liệu ra Excel
ratio_df.to_excel('/nơi_lưu_file_của_bạn/tên_file-ratio_df.xlsx`, index=False')
# Xuất dữ liệu ra CSV
ratio_df.to_csv('/nơi_lưu_file_của_bạn/tên_file-ratio_df.csv`, index=False')

V. 🙋‍♂️ Thông tin liên hệ

Bạn có thể kết nối với tác giả qua các hình thức sau. Trong trường hợp cần hỗ trợ nhanh, bạn có thể chọn nhắn tin qua Messenger hoặc Linkedin, tôi sẽ phản hồi ngay lập tức nếu có thể trong hầu hết các trường hợp.

VI. 🔑 Giấy phép sử dụng (License)

Vnstock3 được phát hành theo giấy phép tuỳ chỉnh hướng đến cá nhân, không dành cho mục đích thương mại. Quyền sử dụng được quy định cụ thể trong giấy phép kèm theo. Nếu bạn hoặc tổ chức bạn đang làm việc muốn sử dụng Vnstock có thể liên hệ tác giả để hiểu rõ phạm vi sử dụng và được cấp phép chính thức.

Khi sử dụng Vnstock trong dự án của mình, bạn cần trích dẫn thông tin về tác giả và dự án theo hướng dẫn của Vnstock.

VI. Lịch sử lượt yêu thích

Bạn có thể hỗ trợ dự án bằng cách cực kỳ đơn giản là đánh dấu yêu thích để giúp dự án có thể tiếp cận tới nhiều người hơn. Dưới đây là lịch sử lượt yêu thích của dự án.

](https://star-history.com/#thinh-vu/vnstock&Date)