Lịch sử phiên bản – Vnstock Pipeline

01-08-2026

Phát hành vnstock_pipeline phiên bản 2.3.2 - Hỗ trợ trích xuất và cập nhật dữ liệu trực tiếp sang phần mềm AmiBroker trên máy tính Windows.

Tính Năng Nổi Bật

Cập Nhật Dữ Liệu AmiBroker Trực Tiếp: Xuất và nạp dữ liệu giá (đã điều chỉnh và chưa điều chỉnh), chỉ số thị trường, cùng dữ liệu giao dịch Khối ngoại & Tự doanh trực tiếp vào phần mềm AmiBroker đang mở trên máy tính qua OLE.
Chế Độ Cập Nhật Liên Tục (Chạy Ngầm): Theo dõi và nạp thêm dữ liệu mới nhất vào AmiBroker theo khoảng thời gian bạn cài đặt mà không cần thao tác tệp thủ công.
Thêm Các Câu Lệnh Tiện Ích: Cung cấp các câu lệnh dễ dùng để thiết lập xuất dữ liệu và điều phối các nhóm tác vụ định kỳ.

Cải Tiến Hệ Thống

Quản Lý Cài Đặt Tập Trung: Sử dụng một file cấu hình duy nhất (pipeline.toml) để thiết lập nơi lưu trữ, định dạng file mặc định (ví dụ: .csv, .parquet) một cách dễ dàng.
Hoạt Động Ổn Định Hơn: Cải thiện độ ổn định và tính an toàn khi cập nhật dữ liệu cho danh sách mã dài, hệ thống tự tạo sẵn các thư mục cần thiết và xử lý mượt mà hơn khi phát sinh lỗi kết nối.

20-06-2026

Phát hành vnstock_pipeline phiên bản 2.3.1 cấu trúc lại toàn bộ kiến trúc lưu trữ dữ liệu, giới thiệu file cấu hình tập trung pipeline.toml và cải tiến mạnh mẽ CLI hỗ trợ quản trị cơ sở dữ liệu chứng khoán hiệu quả.

Thay Đổi Mang Tính Phá Vỡ

Gỡ bỏ DuckDBProcessor & FirebaseProcessor: Cấu trúc mới tập trung gom dữ liệu thô lưu trữ định dạng Parquet/CSV hiệu suất cao. Người dùng tự quản lý Data Warehouse (DuckDB/Supabase) theo nhu cầu. Thay đổi này ít tác động tới người dùng vì cách dùng này không được giới thiệu chính thức.
Quản lý tập trung tham số base_path: Không cần truyền base_path khi khởi tạo Exporter trong các pipeline tùy biến; đường dẫn được đọc trực tiếp từ cấu hình tập trung.
Công cụ di chuyển dữ liệu cũ: Bổ sung lệnh CLI python -m vnstock_pipeline.cli storage migrate-legacy hỗ trợ người dùng chuyển đổi thư mục dữ liệu cũ sang cấu trúc phân lớp tập trung mới một cách an toàn.

Tính Năng Nổi Bật

Kiến Trúc Lưu Trữ Tập Trung (pipeline.toml): Quản lý thiết lập đường dẫn (base_path), chế độ lưu mặc định (parquet/csv/excel) và cơ chế ghi đè định dạng (format_overrides) cho từng nhóm dữ liệu ngay tại ~/.vnstock/config/pipeline.toml.
Linh Hoạt 2 Chế Độ Phân Cấp Thư Mục:
- Flat Layout (Mặc định): Thân thiện cho người dùng cá nhân (ví dụ: ~/stock_db/ohlcv/ACB.parquet).
- Nested Layout: Phân cấp chuẩn mực ([layer]/[domain]/...), tối ưu cho người dùng chuyên sâu và AI Agent.
Bảo Vệ An Toàn Cấu Trúc Dữ Liệu: So sánh dữ liệu mới tải với cấu trúc chuẩn (Baseline Schema). Cách ly an toàn các file lỗi hoặc thay đổi cấu trúc nghiêm trọng vào .tmp/.quarantine/ nhằm bảo vệ CSDL chính.
Xử Lý Lỗi & Khôi Phục Thông Minh: Ghi nhận file error_log.csv cho các mã lỗi do rớt mạng hoặc thiếu dữ liệu. Cung cấp cờ --retry-errors để tải bù đúng những mã thất bại thay vì chạy lại từ đầu.
Công Cụ Quản Trị Bằng Dòng Lệnh (CLI): Cung cấp nhiều lệnh mới tiện dụng như kiểm toán CSDL (storage audit), đổi định dạng (set-format), dọn rác định kỳ (cleanup), trích xuất cấu trúc nhanh (storage preview).
Khởi Tạo Rổ Thanh Khoản (Universe): Lệnh universe build-liquidity giúp xếp hạng tính thanh khoản các cổ phiếu qua đa khung thời gian để sinh ra tệp theo dõi lưu mặc định vào cấu hình liquidity_auto.
Template Pipeline Tích Hợp Sẵn: Hỗ trợ các tác vụ như gom 5 bảng báo cáo tài chính vào Multi-sheet Excel, tải tin tức thị trường có lọc trùng lặp qua bộ đệm Streaming, và cập nhật sự kiện doanh nghiệp liền mạch.
Trích Xuất Chuẩn Amibroker: Tích hợp module DuckDB tại chỗ, xuất nhanh toàn bộ dữ liệu ra định dạng .csv chuẩn tương thích Amibroker bằng một dòng lệnh.

19-05-2026

Cập nhật và sửa lỗi cho vnstock_pipeline phiên bản 2.2.3

Sửa ceiling_price: Khắc phục lỗi cột giá trần (ceiling_price) bị gắn sai giá trị các cờ màu sắc (như e, d) do nhầm lẫn ánh xạ với một trường mã màu trong dữ liệu gốc.
Thêm thông tin giá: Tách và trích xuất chính xác giá trị số cho giá trần (ceiling_actual), giá sàn (floor_price), và giá tham chiếu (reference_price) cho cả cổ phiếu cơ sở và phái sinh.
Sửa market_id cho Phái sinh: Chuẩn hóa sàn giao dịch thành HNX cho dữ liệu hợp đồng tương lai phái sinh (stockps).

18-05-2026

Phiên bản vnstock_pipeline 2.2.2 mang đến nhiều nâng cấp quan trọng giúp bạn xây dựng hệ thống quản lý tải dữ liệu và kết nối dữ liệu trong phiên qua WebSocket gọn và dễ dùng hơn. Các cập nhật mới nhất giúp cải thiện độ tương thích của các thư viện trong hệ sinh thái Vnstock với chuẩn Unified UI mới nhất.

Cảnh báo chỉ báo & Dữ liệu trong phiên

Hệ thống luồng dữ liệu được tối ưu hoá với redis, cung cấp sẵn các kịch bản thường dùng để theo dõi chỉ báo, giúp bạn:

Nhận cảnh báo: Phát hiện các điều kiện chỉ báo (giao cắt MACD, quá mua/quá bán RSI, đột biến dòng tiền...) và gửi cảnh báo về kênh Discord của bạn qua Webhook.
Tự kết nối lại: Thuật toán kết nối mới giúp hệ thống ổn định hơn và tự kết nối lại khi rớt mạng.

Xem nhanh dữ liệu không cần mở trình soạn thảo

Công cụ dòng lệnh tích hợp mới (vnstock_pipeline) giúp bạn tiết kiệm thời gian:

Xem nhanh tổng quan, dung lượng và cấu trúc của bất kỳ tệp dữ liệu chứng khoán nào chỉ với các lệnh CLI đơn giản mà AI Agent có thể sử dụng như một công cụ.
Lọc, tìm kiếm (ví dụ: lọc các mã có giá > 50) và xem thống kê dữ liệu ngay trên cửa sổ lệnh mà không cần phải khởi động các phần mềm phân tích nặng nề.

Quản lý chất lượng & độ toàn vẹn dữ liệu

Kiểm định chất lượng: Hệ thống kiểm tra, phát hiện và cảnh báo các khoảng trống hoặc lỗi bất thường trước khi lưu trữ.
Trực quan & Dễ tích hợp: Toàn bộ tên mã chứng khoán và định dạng báo cáo tài chính đều được chuẩn hóa thống nhất, dễ đọc và dễ dàng đưa vào phần mềm riêng của bạn.

29-08-2025

Phát hành phiên bản Vnstock Pipeline 2.0.1 nâng cấp cơ chế tải dữ liệu Intraday và streaming dữ liệu trong phiên qua WebSocket.

Xem hướng dẫn

Để cài đặt bản cập nhật, vui lòng chạy lại chương trình cài đặt của Vnstock tại đây.

Bổ sung tài liệu hướng dẫn tuỳ biến chương trình
Cải thiện trải nghiệm sử dụng: tuỳ chọn địa điểm lưu file khi streaming, lọc dữ liệu mong muốn thay vì tự lưu toàn bộ.
Cải thiện khả năng truy cập dữ liệu intraday liên tục trong phiên giao dịch và ghép nối thông minh hơn.
Bổ sung tính năng Data Manager cho phép quản lý cấu trúc dữ liệu lưu trữ khoa học và chặt chẽ
Bổ sung khả năng lưu trữ dữ liệu định dạng parquet, tệp nhỏ hơn đáng kể so với CSV và tăng hiệu năng xử lý.

Mục lục