So sánh Bản cộng đồng vs Bản tài trợ
Cập nhật lần cuối:
Thảo luậnMục lục
Unified UI
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 cung cấp cái nhìn chi tiết và khách quan nhất về sự khác biệt giữa phiên bản cộng đồng (vnstock) và phiên bản tài trợ (vnstock_data) thông qua giao diện Unified UI. Chúng tôi sử dụng vnstock_data làm chuẩn tham chiếu cao nhất để chỉ ra những thiếu hụt hoặc giới hạn của bản miễn phí.
1. So sánh Cấu trúc Domain & Lớp
Hệ thống Unified UI được thiết kế đồng bộ, nhưng bản Tài trợ 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 tài trợ) | 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 sponsor | |
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 | |
fund | history, nav... | Đầy đủ | Giới hạn API, thời gian thực hiện phân tích chậm hơn dùng bản Sponsor | |
| 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 Sponsor cho định giá P/E, P/B toàn thị trường |
| Macro | commodity | Không hỗ trợ | 11 methods | Dữ liệu chỉ có ở bản Sponsor: Giá cao su, ngô, dầu, lợn, thép... toàn cầu & VN |
currency | Không hỗ trợ | 2 methods | Dữ liệu chỉ có ở bản Sponsor: Tỷ giá & Lãi suất liên ngân hàng (MBK) | |
economy | Không hỗ trợ | 8 methods | Dữ liệu chỉ có ở bản Sponsor: GDP, CPI, FDI, Xuất nhập khẩu, Lao động... | |
| Insights | ranking | Không hỗ trợ | 7 methods | Dữ liệu chỉ có ở bản Sponsor: 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 Sponsor: Bộ lọc cổ phiếu toàn thị trường (VCI Engine) |
2. So sánh Nguồn Dữ liệu
Bản Tài trợ tích hợp các nguồn dữ liệu trực tiếp từ các tổ chức lớn, đảm bảo tính chính xác và tốc độ vượt trội so với các nguồn crawler của bản miễn phí.
| Nhóm Dữ liệu | Vnstock (Bản cộng đồng) | Vnstock Data (Bản tài trợ) | Lợi thế bản tài trợ |
|---|---|---|---|
| Giá trực tuyến | KBS, VCI* | MAS, KBS, VCI, VND | Nhiều nguồn dữ liệu thay thế VCI cho tốc độ cao. VCI có thể bị chặn trên 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 (Crawler) | Binance API | Dữ liệu API chính thức từ sàn Binance, ổn định |
| Hàng hóa/Forex | MSN (Crawler) | Dukascopy, SPL | Dữ liệu chuẩn quốc tế từ nguồn dữ liệu uy tín, ổn định |
| Vĩ mô | Không có | MBK, SPL | 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 tài trợ) |
|---|---|---|
| Độ 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) |
| Rate Limit | Rất thấp (Chương trình bị gián đoạn khi gọi liên tục) | Cao (Phù hợp cho chương trình tự động hoặc chạy trên Server) |
| 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 |
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:
- Hệ thống phân tích tự động / Bot: Cần dữ liệu tần suất cao theo thời gian thực và giới hạn API (Rate limit) cao đáp ứng luồng xử lý liên tục.
- 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.
Lư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 tài trợ chỉ bằng một dòng thay đổi lệnh import.
Thảo luận