Giới thiệu Vnstock Chart
Mục lục
Dành cho bất kỳ ai đang dùng Vnstock thế hệ 5 muốn có biểu đồ đẹp, nhất quán, không phải tự tay dò từng dòng Matplotlib — nhà đầu tư cá nhân viết báo cáo, người làm nghiên cứu, lập trình viên tự động hoá, và trợ lý AI đọc hình để nhận định.
Tổng quan
vnstock_chart là một lớp bọc cấp cao trên Matplotlib, Seaborn và mplfinance: bạn đưa vào một DataFrame hay Series có dạng vnstock trả về, thư viện trả lại một biểu đồ tĩnh (PNG/PDF/SVG) đã có sẵn bảng màu, font chữ, chú giải và logo thương hiệu — không cần lặp lại cấu hình cho từng biểu đồ.
Thư viện tập trung hoàn toàn vào biểu đồ tĩnh, vì ba việc thực tế:
- Nghiên cứu & báo cáo in ấn. Ảnh độ nét cao, nhúng thẳng vào báo cáo phân tích, tài liệu PDF, không phụ thuộc trình duyệt.
- Tự động hoá. Xuất ảnh để gửi báo cáo danh mục, tín hiệu kỹ thuật qua Telegram, Discord, Zalo — không cần dựng một trang web riêng chỉ để xem một biểu đồ.
- Trợ lý AI đọc hình. Đưa ảnh tĩnh cho một trợ lý AI (Claude, ChatGPT, Antigravity…) để nó "nhìn" biểu đồ như con người, thay vì chỉ đọc một bảng số — nhận định dựa trên hình ảnh thường đáng tin hơn khi dữ liệu có nhiều chiều.
Hơn 20 loại biểu đồ dựng sẵn, chia theo nhu cầu: xu hướng theo thời gian, nến và khối lượng, phân phối, tương quan, tỉ lệ, và vài biểu đồ chuyên biệt cho định lượng (hiệu suất, drawdown, RRG).
vnstock_chart khác gì vnstock_ezchart?
vnstock_chart là thư viện kế tục vnstock_ezchart — cùng một bộ mã, cùng tác giả, đổi tên đơn giản hơn và phát hành lại trong nhóm thư viện thế hệ 5 của Vnstock (qua kho gói riêng của Vnstock, không phải PyPI công khai). Mục đích đổi tên: một tên ngắn, nhất quán với vnstock, vnstock_quant, vnstock_bt… trong cùng hệ sinh thái, và một kênh phát hành có kiểm thử, quét rò rỉ như mọi thư viện thế hệ 5 khác.
Gói vnstock_ezchart cũ vẫn còn trên PyPI (bản 1.0.2) để những ai đã cài không bị gãy — nhưng không còn được cập nhật. Toàn bộ sửa lỗi và tính năng mới từ nay chỉ có ở vnstock_chart. Chi tiết sự khác biệt và cách chuyển đổi: xem Khác biệt với vnstock_ezchart.
Nếu bạn thấy một gói vnstock_chart khác ở đâu đó mô tả biểu đồ tương tác kiểu TradingView/Bloomberg (dựng trên Bokeh/Panel) — đó là một bản thử nghiệm cũ, chưa từng phát hành, không liên quan tới thư viện đang nói ở đây. Bản chính thức duy nhất của vnstock_chart là thư viện biểu đồ tĩnh mô tả trong tài liệu này.
Bắt đầu nhanh
pip install --extra-index-url https://vnstocks.com/api/packages vnstock-chartfrom vnstock import Market
from vnstock_chart import Chart
df = Market().equity("FPT").ohlcv(start="2024-01-01", end="2024-12-31")
fig, ax = Chart.candle(df, title="FPT — Nến ngày 2024")
fig.savefig("fpt_2024.png", dpi=150, bbox_inches="tight")Xem tiếp Cài đặt, Các loại biểu đồ, Kết hợp với thư viện thế hệ 5 để vẽ trực tiếp từ dữ liệu vnstock, chỉ báo vnstock_quant, hay kết quả backtest vnstock_bt, và Tham chiếu đầy đủ tham số — nơi trợ lý AI tra cứu tên, kiểu, giá trị mặc định của mọi hàm Chart.* để tự động hoá.