So sánh Bản Cộng đồng vs Bản Mở rộng
Mục lục
Bản mặc định hiện là vnstock v5.0.0, gộp bản Cộng đồng và bản Mở rộng vào một thư viện. Trang này giữ lại cho máy còn cài vnstock v4.x: mã viết theo trang này vẫn chạy với bản đó. Đã cài bản mới thì đọc trang tương ứng của v5.0.0.
Máy đang cài bản nào: chạy python -c "import vnstock; print(vnstock.__version__)", ra số bắt đầu bằng 5. là thế hệ 5.
Kể từ phiên bản 4.0, Vnstock sử dụng kiến trúc Unified UI nhằm mang lại giao diện lập trình nhất quán và dễ sử dụng nhất. Dưới đây là tài liệu chính thức cho phiên bản mới.
Tài liệu này so sánh chi tiết sự khác biệt giữa bản Cộng đồng (vnstock) và bản Mở rộng (vnstock_data) thông qua giao diện Unified UI. Tài liệu dùng vnstock_data làm mốc tham chiếu để chỉ ra phạm vi khác nhau giữa hai bản.
1. So sánh Cấu trúc
Hệ thống Unified UI được thiết kế đồng bộ, nhưng bản Mở rộng mở rộng thêm nhiều Domain và Class chuyên sâu để phục vụ phân tích chuyên nghiệp.
| Domain | Lớp (Class) | Vnstock (Bản Cộng đồng) | Vnstock Data (Bản Mở rộng) | Thiếu ở bản Cộng đồng |
|---|---|---|---|---|
| Reference | company | 9 methods (KBS) | 7 methods (VCI/KBS) | Thiếu margin_ratio (Tỉ lệ ký quỹ tại các kho) |
equity | Cơ bản | Đầy đủ | Nguồn dữ liệu phân tích chuyên sâu | |
index | Cơ bản | Đầy đủ | Truy cập đầy đủ bộ chỉ số ngành, chỉ số đầu tư HOSE, HNX, UPCOM trong bản Mở rộng | |
events | Cơ bản | Chuyên sâu | Thiếu market events toàn thị trường | |
search | MSN (Cơ bản) | Dukascopy | Nguồn Dukascopy hoạt động ổn định, ít gián đoạn bất ngờ như MSN | |
bond | list (Cơ bản) | list (Chuyên sâu) | Thiếu phân loại trái phiếu chính phủ/doanh nghiệp chi tiết | |
| Market | equity | 3 methods | 12 methods | Thiếu: block_trades, foreign_flow, odd_lot, proprietary_flow, volume_profile, session_stats, order_book... phục vụ phân tích chuyên sâu |
index | ohlcv | 5 methods | Thiếu: quote, session_stats, trade_history | |
crypto | ohlcv (MSN) | 11 methods | Thiếu: daily_stats, order_book, vwap, rolling_stats, trade_history sử dụng nguồn dữ liệu từ API chính thức của Binane với độ chi tiết cao thay vì dữ liệu miễn phí từ MSN thể hiện thông tin cơ bản, thiếu ổn định | |
commodity | ohlcv (MSN) | 3 methods | Thiếu: quote, summary. Nguồn Dukascopy cho tải dữ liệu lịch sử chi tiết đến cấp độ phút, ổn định | |
| Fundamental | equity | 4 methods | 6 methods | Thiếu: financial_health (Scorecard TCBS), note (Thuyết minh BCTC) |
| Analytics | valuation | Không hỗ trợ | Đầy đủ | Dữ liệu chỉ có ở bản Mở rộng cho định giá P/E, P/B toàn thị trường |
| Macro | commodity | Không hỗ trợ | 9 methods | Dữ liệu chỉ có ở bản Mở rộng: Giá ngô, đường, dầu, thép, quặng sắt... thế giới |
currency | Không hỗ trợ | 5 methods | Dữ liệu chỉ có ở bản Mở rộng: Tỷ giá, lãi suất điều hành, liên ngân hàng và huy động | |
economy | Không hỗ trợ | 8 methods | Dữ liệu chỉ có ở bản Mở rộng: GDP, CPI, FDI, Xuất nhập khẩu, Tín dụng... | |
| Insights | ranking | Không hỗ trợ | 7 methods | Dữ liệu chỉ có ở bản Mở rộng: Xếp hạng tăng/giảm, khối ngoại, giá trị... |
screener | Không hỗ trợ | Đầy đủ | Dữ liệu chỉ có ở bản Mở rộng: Bộ lọc cổ phiếu toàn thị trường (VCI Engine) |
2. So sánh Nguồn Dữ liệu
Với tiền điện tử và hàng hoá/ngoại hối, bản Mở rộng kết nối tới các nguồn có giao diện API riêng cho từng nhóm dữ liệu, còn bản Cộng đồng dùng nguồn MSN. Chất lượng dữ liệu vẫn phụ thuộc vào nguồn.
| Nhóm Dữ liệu | Vnstock (Bản Cộng đồng) | Vnstock Data (Bản Mở rộng) | Lợi thế bản Mở rộng |
|---|---|---|---|
| Giá trực tuyến | KBS, VCI* | MAS, KBS, VCI, VND | Thêm nguồn MAS và VND. Kết nối tới VCI có thể không khả dụng từ Google Colab. |
| Báo cáo tài chính | VCI, KBS (làm sạch thô) | MAS, TCBS Standard | Dữ liệu chuẩn hóa với bộ tiêu chí thường xuyên sử dụng, hạn chế thay đổi cấu trúc do đổi nguồn dữ liệu trong tương lai |
| Tiền điện tử | MSN | Binance API | Kết nối giao diện API công bố của sàn Binance |
| Hàng hóa/Forex | MSN | Dukascopy | Kết nối thêm nguồn Dukascopy |
| Vĩ mô | Không có | ASEAN | Cập nhật định kỳ từ các báo cáo chính thống |
3. Khả năng Kỹ thuật & Hiệu suất
| Tiêu chí | Vnstock (Bản Cộng đồng) | Vnstock Data (Bản Mở rộng) |
|---|---|---|
| Độ phân giải thời gian | Ngày (1D), Giờ (1H), Phút (1M) | Giây (tick-by-tick), **Phút (1m, 5m, 15m, 1H...), Ngày (1D), Tuần (1W), Tháng (1M) |
| Lịch sử dữ liệu | Giới hạn (Tùy nguồn) | Dữ liệu lịch sử dài (toàn bộ dải dữ liệu OHLCV, nhiều kỳ báo cáo tài chính (tùy vào từng nguồn) |
| Hạn mức chung | Mức cơ bản, chia theo giờ, ngày, tháng | Lớn hơn theo cấp tài trợ, dùng chung cho mọi thư viện |
| Hỗ trợ Tick-by-Tick | Không hỗ trợ | Hỗ trợ cho mọi mã chứng khoán & chỉ số trong nước |
| Chuẩn hóa Scorecard | Không có | Tự động phân loại bộ chỉ tiêu cốt lõi (~100 chỉ tiêu) tự động theo nhóm ngành |
Hạn mức là đơn vị kỹ thuật để giữ tải ở mức hợp lý với nguồn, không phải dữ liệu bán theo đơn vị. Bạn xem phần trăm còn lại của giờ, ngày, tháng ở trang tài khoản. Ở cả hai bản, bạn nên lưu dữ liệu đã lấy về máy, chỉ cập nhật phần mới và đặt khoảng nghỉ giữa các yêu cầu.
4. Kết luận: Khi nào nên nâng cấp?
Việc sử dụng vnstock_data là cần thiết nếu quy trình công việc của bạn rơi vào các trường hợp sau:
- Quy trình phân tích tự động chạy định kỳ: Cần các lớp dữ liệu đã chuẩn hoá, ít đổi cấu trúc khi nguồn thay đổi, và pipeline chạy trên hạ tầng của bạn.
- Phân tích chuyên sâu (Institutional Level): Cần sử dụng
financial_health()để so sánh các doanh nghiệp trên cùng một hệ quy chiếu scorecard chuẩn mực. - Quản trị danh mục đa tài sản: Theo dõi đồng thời Cổ phiếu, Crypto, Vĩ mô và Hàng hóa trên cùng một Dashboard Unified UI.
- Sàng lọc cơ hội: Cần dùng
screenerđể tìm ra "siêu cổ phiếu" dựa trên hàng trăm tiêu chí định lượng thay vì lọc thủ công.
Người tài trợ nhận quyền sử dụng phần mềm mở rộng có thời hạn, hạn mức cao hơn và mức ưu tiên hỗ trợ cao hơn. Vnstock không bán dữ liệu.
Bạn có thể chạy show_api() trên cả hai phiên bản để tự mình đối chiếu sự chênh lệch khổng lồ về số lượng hàm (50 vs 150+). Mọi mã nguồn viết trên bản Cộng đồng đều có thể chuyển đổi sang bản Mở rộng chỉ bằng một dòng thay đổi lệnh import.