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

<div id="badges" align="center"> <img src="https://img.shields.io/pypi/pyversions/vnstock?logoColor=brown&style=flat" alt="Version"/> <img src="https://img.shields.io/github/last-commit/thinh-vu/vnstock?style=flat" alt="Commit Badge"/> <img src="https://img.shields.io/badge/license-Custom%20License-red?style=flat" alt="Custom License Badge"/> </div> <div id="badges" align="center"> <a href="https://pypi.org/project/vnstock/"> <img src="https://img.shields.io/pypi/dm/vnstock?label=vnstock%20download&style=flat" alt="vnstock download badge"/> </a> </div> <div id="badges" align="center"> <a href="https://vnstocks.com/insiders-program"> <img src="https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86" alt="vnstock3 download badge"/> </a> </div> ---

⚠️ Note: This document begins in 🇻🇳 Vietnamese for our local community.

🌐 English version available below — scroll or use the TOC (top-right 🟰) to navigate.

---

🎤 Giới thiệu về Vnstock

Chào mừng bạn đến với Vnstock, bộ giải pháp mã nguồn mở toàn diện cho phân tích và tự động hóa đầu tư chứng khoán.

Với sứ mệnh "Mang dữ liệu chứng khoán và công cụ đầu tư đến gần hơn với tất cả mọi người", Vnstock liên tục cải tiến, tích hợp những công nghệ hiện đại để không chỉ đáp ứng nhu cầu cơ bản về dữ liệu, mà còn giúp bạn xây dựng các giải pháp phân tích tài chính thông minh và linh hoạt hơn bao giờ hết.

🚀 Tại sao chọn Vnstock?

• Hoàn toàn miễn phí & mã nguồn mở: Dễ dàng truy cập và sử dụng, phù hợp với nhà đầu tư cá nhân, nhà phân tích, và cộng đồng nghiên cứu.
• Giải pháp Python toàn diện: Các hàm chức năng thân thiện, dễ dàng tích hợp để xây dựng các công cụ phân tích, bot giao dịch tự động.
• Dữ liệu đa dạng, cập nhật liên tục: Bao gồm cổ phiếu, chứng quyền, chỉ số thị trường, hợp đồng tương lai, trái phiếu, ngoại hối, crypto và nhiều hơn thế nữa.

Bạn chính là một phần quan trọng trong hành trình chuyển đổi số thị trường tài chính Việt Nam. Hãy cùng Vnstock tạo nên những thay đổi tích cực và hiệu quả!

🤝 Tham gia cộng đồng cùng chúng tôi!

Tham gia ngay cộng đồng Vnstock để giao lưu, chia sẻ kinh nghiệm và cập nhật những tính năng mới nhất từ dự án:

<div id="badges" align="center"> <a href="https://www.facebook.com/groups/vnstock.official" target="_blank"> <img src="https://img.shields.io/badge/Tham%20gia%20cộng%20đồng-Vnstock-blue?style=for-the-badge&logo=facebook" alt="Tham gia cộng đồng Vnstock"/> </a> </div>

---

II. Các nhóm tính năng chính

Vnstock giúp rút ngắn thời gian xử lý dữ liệu, hỗ trợ học tập, nghiên cứu và xây dựng hệ thống phân tích giao dịch tài chính một cách hiệu quả – không chỉ là một công cụ trích xuất dữ liệu, mà là nền tảng để phát triển giải pháp đầu tư cá nhân thông minh. Thư viện được thiết kế dễ dàng sử dụng và tích hợp vào các hệ thống phân tích, nghiên cứu, trang tổng quan, hoặc bot chứng khoán.

1. Truy xuất dữ liệu qua API đơn giản

Dễ dàng truy cập dữ liệu thông qua các hàm Python thân thiện, giúp tích hợp nhanh vào hệ thống phân tích tự động hoặc bot giao dịch.

2. Dữ liệu cổ phiếu

Giá cổ phiếu thời gian thực, dữ liệu lịch sử, chỉ số tài chính và thông tin doanh nghiệp của các mã niêm yết.

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

Hỗ trợ lọc cổ phiếu theo tiêu chí tài chính, kỹ thuật hoặc thị trường để phục vụ phân tích. (tạm thời không hoạt động)

4. Chỉ số thị trường (Index)

Theo dõi hiệu suất các chỉ số trong nước (VNIndex, HNXIndex, UPCOM) và một số chỉ số quốc tế.

5. Chứng quyền (CW)

Thông tin chứng quyền bao gồm giá, ngày đáo hạn, tổ chức phát hành và trạng thái thị trường.

6. Kim loại quý

Cập nhật giá vàng trong nước và thế giới.

7. Hợp đồng tương lai (Phái sinh)

Dữ liệu hợp đồng tương lai như VN30F và các kỳ hạn giao dịch.

8. Quỹ đầu tư (ETF & Quỹ mở)

Thông tin về danh mục, hiệu suất và các chỉ số liên quan của quỹ đầu tư.

9. Trái phiếu

Dữ liệu trái phiếu Chính phủ và doanh nghiệp bao gồm kỳ hạn, lãi suất và khối lượng giao dịch.

10. Ngoại hối (Forex)

Tỷ giá cập nhật theo thời gian thực của các cặp tiền tệ phổ biến.

11. Tiền điện tử (Crypto)

Giá cả và biến động thị trường của các loại tiền điện tử lớn.

12. Tin tức & sự kiện tài chính

Tự động cập nhật tin tức, công bố thông tin doanh nghiệp và lịch sự kiện thị trường.

---

III. Tuyên bố miễn trừ trách nhiệm

Dự án Vnstock được phát triển nhằm phục vụ mục đích nghiên cứu và sử dụng cá nhân. Dữ liệu cung cấp có thể không đầy đủ, không liên tục hoặc sai lệch so với thực tế, do đó không khuyến nghị sử dụng cho mục đích giao dịch thực tế, thuật toán đầu tư, hoặc ra quyết định tài chính khi bạn không hiểu rõ.

Các tác giả không chịu trách nhiệm đối với bất kỳ tổn thất hay thiệt hại nào phát sinh từ việc sử dụng dữ liệu hoặc mã nguồn này, bao gồm nhưng không giới hạn: sai lệch dữ liệu, mất mát tài chính, hoặc sử dụng sai mục đích.

Vnstock không cung cấp tư vấn đầu tư hay tín hiệu giao dịch. Người dùng hoàn toàn tự chịu trách nhiệm khi sử dụng dự án.

---

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

Vnstock đượ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.

---

V. 🙏 Bạn đồng hành & tài trợ

Bạn đồng hành

Vnstock phát triển nhờ sự chung tay của cộng đồng những người yêu thích công nghệ và tài chính. Mỗi dòng code, mỗi bản sửa lỗi đều là minh chứng cho sự đóng góp quý giá của các bạn. Cảm ơn vì đã biến vnstock thành công cụ mạnh mẽ cho cộng đồng đầu tư Việt Nam!

<a href="https://github.com/thinh-vu/vnstock/graphs/contributors"> <img src="https://contributors-img.web.app/image?repo=thinh-vu/vnstock" width="800"/> </a>

❤️ Nhà tài trợ nổi bật

Từ tận đáy lòng, Vnstock gửi lời tri ân sâu sắc đến những người đã tin tưởng và ủng hộ vnstock. Sự đóng góp của các bạn không chỉ là nguồn lực tài chính – mà còn là niềm tin, sự khích lệ và là động lực mạnh mẽ để chúng tôi tiếp tục phát triển, tối ưu hóa và lan tỏa công cụ này đến cộng đồng đầu tư Việt Nam.

Dù lớn hay nhỏ, mỗi sự hỗ trợ đều là một lời nhắc nhở rằng chúng tôi không đi một mình. Các bạn là những đối tác đồng hành, những người tiên phong chung tay kiến tạo một hệ sinh thái dữ liệu tài chính dễ tiếp cận và minh bạch hơn cho mọi nhà đầu tư.

<div style="display: flex; flex-wrap: wrap; gap: 10px;"> <!-- Present & Past sponsors --> <a href="https://github.com/Huytq82"><img src="https://avatars.githubusercontent.com/u/68698802?s=100&v=4" width="60px" alt="Huytq82" style="border-radius: 50%;" /></a> <a href="https://github.com/yellow1912"><img src="https://avatars.githubusercontent.com/u/374134?s=100&v=4" width="60px" alt="yellow1912" style="border-radius: 50%;" /></a> <a href="https://github.com/thaituankha"><img src="https://avatars.githubusercontent.com/u/136249921?s=100&v=4" width="60px" alt="thaituankha" style="border-radius: 50%;" /></a> <a href="https://github.com/huannguyen2606"><img src="https://avatars.githubusercontent.com/u/207012732?s=100&v=4" width="60px" alt="huannguyen2606" style="border-radius: 50%;" /></a> <a href="https://github.com/hungson175"><img src="https://avatars.githubusercontent.com/u/565789?s=100&v=4" width="60px" alt="hungson175" style="border-radius: 50%;" /></a> <a href="https://github.com/kynnbreak"><img src="https://avatars.githubusercontent.com/u/60998063?s=100&v=4" width="60px" alt="kynnbreak" style="border-radius: 50%;" /></a> <a href="https://github.com/quanglaife"><img src="https://avatars.githubusercontent.com/u/153795419?s=100&v=4" width="60px" alt="quanglaife" style="border-radius: 50%;" /></a> <a href="https://github.com/itkennylee"><img src="https://avatars.githubusercontent.com/u/206494183?s=100&v=4" width="60px" alt="itkennylee" style="border-radius: 50%;" /></a> <a href="https://github.com/congnt91"><img src="https://avatars.githubusercontent.com/u/191594462?s=100&v=4" width="60px" alt="congnt91" style="border-radius: 50%;" /></a> <a href="https://github.com/NATien1999"><img src="https://avatars.githubusercontent.com/u/155497138?s=100&v=4" width="60px" alt="NATien1999" style="border-radius: 50%;" /></a> <a href="https://github.com/khanhnl2806"><img src="https://avatars.githubusercontent.com/u/202572860?s=100&v=4" width="60px" alt="khanhnl2806" style="border-radius: 50%;" /></a> <a href="https://github.com/Namdo1402"><img src="https://avatars.githubusercontent.com/u/205231143?s=100&v=4" width="60px" alt="Namdo1402" style="border-radius: 50%;" /></a> <a href="https://github.com/VNNTNAM"><img src="https://avatars.githubusercontent.com/u/199906888?s=100&v=4" width="60px" alt="VNNTNAM" style="border-radius: 50%;" /></a> <a href="https://github.com/NguyenNgocHuyhub"><img src="https://avatars.githubusercontent.com/u/174630720?s=100&v=4" width="60px" alt="NguyenNgocHuyhub" style="border-radius: 50%;" /></a> <a href="https://github.com/quy0193"><img src="https://avatars.githubusercontent.com/u/90856171?s=100&v=4" width="60px" alt="quy0193" style="border-radius: 50%;" /></a> <a href="https://github.com/hieuvoquang87"><img src="https://avatars.githubusercontent.com/u/8354819?s=100&v=4" width="60px" alt="hieuvoquang87" style="border-radius: 50%;" /></a> <a href="https://github.com/DrDinhLuong"><img src="https://avatars.githubusercontent.com/u/86107710?s=100&v=4" width="60px" alt="DrDinhLuong" style="border-radius: 50%;" /></a> <a href="htt