Vnstock Logo

Lịch sử phiên bản

Mở rộng

Mục lục

Trang này gom thay đổi của bản Mở rộng từ nhật ký riêng của từng thư viện, xếp theo ngày. Nhãn [Mở rộng] đánh dấu phần chỉ có ở bản Mở rộng. Muốn đọc riêng một thư viện, mở mục Lịch sử phiên bản trong tài liệu của thư viện đó.

18-10-2026

vnstock_chart (v1.0.0)

Đổi tên từ vnstock_ezchart để phát hành cùng nhóm thư viện thế hệ 5

  • Đổi tên: vnstock_ezchart thành vnstock_chart. Tên hàm, tham số và cách dùng giữ nguyên; chỉ đổi tên gói và câu import. Hai gói pip khác tên, cài độc lập nhau; cách chuyển xem khác biệt với vnstock_ezchart.
  • Phát hành qua kho gói Vnstock: Cài bằng pip install --extra-index-url https://vnstocks.com/api/packages vnstock-chart, như các thư viện thế hệ 5 khác.
  • Phụ thuộc: Yêu cầu vnstock>=5.0. squarify (cho treemap()) và wordcloud là phụ thuộc tuỳ chọn, cài bằng vnstock-chart[all]; thiếu chúng thì các hàm còn lại vẫn chạy.
  • Sửa lỗi đóng gói: Bản cài qua pip install có đủ mọi thư mục con, không còn lỗi ModuleNotFoundError mà vnstock_ezchart 1.0.1 và 1.0.2 gặp.

17-10-2026

vnstock_quant (v0.4.0)

Dữ liệu khung phút

  • [Mở rộng] Ichimoku: Với nến trong ngày, span tương lai đi tiếp theo nhịp phiên giao dịch có trong dữ liệu (bỏ qua giờ nghỉ trưa, hết phiên thì sang ngày làm việc kế tiếp), thay vì lùi xa 26 ngày. Thị trường giao dịch cả cuối tuần (ví dụ tiền mã hoá) được giữ Thứ 7 và Chủ nhật. Nến ngày không đổi.
  • [Mở rộng] Ichimoku với cột thời gian: Bảng có cột time (hoặc date, ngay...) trên chỉ mục số thứ tự, như dữ liệu trả về từ vnstock, nay có span tương lai đánh chỉ mục theo thời gian. Bảng chính vẫn giữ chỉ mục của bạn.
  • VWAP và pivots: Đọc được cột thời gian dạng dd/mm/YYYY HH:MM và dd/mm/YYYY HH:MM:SS.
  • [Mở rộng] MFI: Khi dữ liệu có nến thiếu giá trị, chỉ báo trả NaN cho các cửa sổ chứa nến đó, không còn dừng chương trình.
  • [Mở rộng] Rủi ro (risk): Lợi suất theo phút được gộp thành lợi suất ngày trước khi tính các thước đo năm hoá, và được ghép với chuẩn so sánh theo đúng mốc thời gian (kể cả khi một bên thiếu vài phút). Áp dụng cho các hàm risk và portfolio.risk_decomposition. Lợi suất ngày cho kết quả như trước.
  • Chỉ số tài chính (fa): Bảng giá theo phút được đọc thành một phiên mỗi ngày, lấy giá của nến cuối ngày (kể cả phiên ATC). Bảng giá ngày không đổi.

Thay đổi khác

  • [Mở rộng] portfolio: Bổ sung tham số flow_dates cho twr, periods cho covariance, lịch tái cân bằng M/Q/Y cho portfolio_returns, và weights/benchmark_weights cho ex_ante_tracking_error (active_weights không còn bắt buộc). Cách gọi cũ cho kết quả như cũ.
  • [Mở rộng] portfolio.twr: Chạy được với chỉ mục ngày có múi giờ.
  • [Mở rộng] fa.Dataset.from_frames: Bỏ các dòng giá thiếu thời gian; chuỗi thời gian lẫn nhiều múi giờ khác nhau báo ValueError.
  • Thông báo lỗi: vwap với anchor không hợp lệ báo InvalidParameterError bằng tiếng Việt, giống micro.cvd.
  • Chú thích hàm: Chú thích viết bằng tiếng Anh; mô tả ngắn của 58 chỉ báo viết song ngữ (tiếng Anh trước, tiếng Việt sau). Công thức và phương pháp chi tiết xem ở các trang tài liệu.
  • Đo lượt dùng: Câu hỏi đồng ý đo lượt dùng ở lần chạy đầu thống nhất giữa các thư viện thế hệ 5.

15-10-2026

vnstock

Cập nhật Vnstock 5.0.3

Bản này thay cho 5.0.2 (đã rút khỏi kho gói). Hướng đi của thư viện: mọi con số bạn nhận được đều kiểm chứng được. Số liệu một nguồn tự tính theo phương pháp riêng, không công bố cách tính, không còn được cung cấp; phần tính toán do các thư viện tính toán và phân tích của Vnstock đảm nhận, chạy trên máy bạn, theo công thức công khai.

Shell
pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock

Không còn hỗ trợ. Các hàm dưới đây giữ tên để mã cũ không lỗi khi import, nhưng gọi là báo UnsupportedError mã VNSTOCK_FEATURE_REMOVED:

  • [Mở rộng] Insights().flow.active(): dòng tiền mua, bán chủ động. Lệnh khớp nào tính là bên chủ động do nguồn tự phân loại.
  • [Mở rộng] Insights().sector(...): flow(), flow_intraday(), index_intraday(), valuation(), rrg(); Insights().equity(...): order_flow(), order_flow_history(), peer_compare(), rrg(). Các hàm này chưa từng trả dữ liệu ở thế hệ 5; nay báo rõ là không làm.
  • [Mở rộng] Reference().company(...).ratio_summary().
  • Các hàm cùng loại ở lớp tương thích vnstock.explorer.asean (RRG, tín hiệu, chỉ số sợ hãi và tham lam, mua bán chủ động, định giá và dòng tiền ngành, so sánh cùng ngành).

Thay đổi cần lưu ý

  • [Mở rộng] Insights().sentiment.breadth() bỏ ba cột pe, pb, position_line (số liệu nguồn tự tính). Bảng giữ các cột tỷ lệ mã có giá trên đường trung bình 20 và 50 phiên.
  • [Mở rộng] Fundamental().equity(...).ratio() dùng được đến hết ngày 15/01/2027, mỗi lần gọi kèm FutureWarning. Bảng này do mỗi nguồn tự tính bằng công thức riêng. Hãy chuyển sang vnstock_quant.fa.ratios(): chỉ số tính trên máy bạn từ báo cáo tài chính công bố đã chuẩn hoá, theo công thức công khai đã kiểm chứng.

Dòng lệnh

  • vnstock tools thay cho vnstock api: cây các hàm để bạn tự truy xuất dữ liệu. Cây chỉ hiện hàm nên dùng; tên cũ, tên khác, hàm sắp bỏ và không còn hỗ trợ vẫn gọi được và vẫn xem được bằng vnstock doc. Gõ vnstock api vẫn chạy.
  • vnstock onboard (mới): hướng dẫn ngắn cho trợ lý AI trước khi làm việc với vnstock, gồm phiên bản, cấp và thư viện bổ sung trên máy, quy tắc cần theo, bước tiếp theo theo cấp và các skill cấp đó đọc được. Câu lệnh khởi động trên vnstocks.com/onboard nay bảo trợ lý chạy lệnh này đầu tiên.
  • vnstock skills show <tên> chỉ in phần giới thiệu công khai của skill (mô tả, cấp cần có, trang giới thiệu); nội dung skill dành cho trợ lý AI đọc trong phiên làm việc.

Cải thiện khác

  • Thông tin trích dẫn nguồn trong df.attrs (tên nguồn, đường dẫn điều khoản, tuyên bố miễn trừ) được cập nhật từ vnstocks.com, không cần chờ bản mới.
  • Gói cài nhẹ hơn: thư viện lõi trên macOS ARM giảm từ 10,3 MB xuống 7,9 MB.

vnstock_news (v3.1.1)

Bản 3.x trên lõi Rust, thuộc đợt phát hành Vnstock thế hệ 5

  • Lõi xử lý mới: Bản 3.x chạy trên lõi Rust biên dịch sẵn, thay cho lõi Python của bản 2.x. Các lớp cũ (Crawler, BatchCrawler, AsyncBatchCrawler, EnhancedNewsCrawler, Cache, ContentCleaner, InputValidator) vẫn dùng được, nên mã viết cho bản 2.x chạy tiếp mà không phải viết lại.
  • Hai hàm gọn mới: fetch_feeder() lấy danh sách tin mới, fetch_articles() đọc chi tiết bài viết. Bảng đối chiếu mã cũ và mới xem ở chuyển đổi từ bản cũ.
  • Sửa lỗi lệch giờ: Lọc within="1h" không còn lấy nhầm bài của 8 tiếng trước; thời gian chuẩn hoá theo giờ Việt Nam (UTC+07:00).
  • Nhận diện thời gian tiếng Việt: Các dạng tương đối như "5 phút trước", "hôm qua" được đổi về ngày giờ chuẩn.
  • Sửa lỗi dính chữ: Chữ không còn bị nối liền (Giávàngtăng nay đọc đúng là Giá vàng tăng).
  • An toàn kết nối: Xác thực TLS luôn bật mặc định, chặn các chuyển hướng không an toàn.
  • Tiện hơn khi import: SITES_CONFIG và SUPPORTED_SITES import thẳng từ vnstock_news.
  • [Mở rộng] Quyền sử dụng: Thư viện dành cho người dùng bản Mở rộng từ cấp Silver trở lên.

vnstock_pipeline (v3.1.1)

Bản 3.x trên lõi Rust, thuộc đợt phát hành Vnstock thế hệ 5

  • Lõi xử lý mới: Bản 3.x chạy trên lõi Rust biên dịch sẵn, xử lý nhanh hơn bản 2.x khi thư mục dữ liệu lớn.
  • Cấu hình tập trung: Vị trí lưu, định dạng tệp (Parquet nén hoặc CSV) và cấu trúc thư mục do tệp pipeline.toml điều khiển, quản lý bằng giao diện dòng lệnh.
  • Tải bù theo mã lỗi: Mã gặp sự cố mạng được ghi vào sổ nhật ký, tuỳ chọn --retry-errors tải bù đúng các mã đó mà không phải chạy lại từ đầu.
  • Cách ly tệp bất thường: Khi cấu trúc cột đổi hoặc dữ liệu rỗng, đứt gãy thời gian, tệp được chuyển vào vùng .quarantine, không lẫn vào kho chính.
  • Cây thư mục tự dựng: Cây thư mục dữ liệu hiển thị ngay từ thư viện, không cần công cụ tree cài thêm.
  • Cách nâng cấp: xem nâng cấp từ bản 2.x.
  • [Mở rộng] Quyền sử dụng: Thư viện dành cho người dùng bản Mở rộng từ cấp Golden trở lên.

12-10-2026

vnstock_mcp (v0.4.0)

Bản đầu tiên có tài liệu

  • Cầu nối chạy cục bộ: Trợ lý AI trên máy bạn khởi chạy tiến trình vnstock-mcp từ môi trường Python cá nhân; không có máy chủ trung gian đứng giữa.
  • Kết nối bằng một lệnh: vnstock-mcp --setup <ứng dụng> in sẵn cấu hình cho Claude Desktop, ChatGPT desktop, Gemini Tasks, Claude Code, Codex, Antigravity, VS Code và Cursor; thêm --write để ghi thẳng vào tệp cấu hình.
  • Mã tham chiếu và mã Python tái lập: Mỗi kết quả lưu trong không gian làm việc cục bộ kèm mã call_id (c1, c2...) và ghi vào nhật ký phiên. research_journal(method="script") xuất các bước đã chạy thành một tệp Python độc lập.
  • Công cụ nghiên cứu: research_normalize chuẩn hoá bảng về cột chuẩn của Vnstock, research_benchmark đối chiếu số liệu, research_universe tra danh mục chỉ tiêu VAS. Các mô-đun vnstock_quant gọi được trên bảng đã chuẩn hoá qua data="c1".
  • Lọc công cụ theo hồ sơ và quyền: Trợ lý AI chỉ thấy công cụ khả dụng với tài khoản và hồ sơ (--profile) bạn chọn.
  • [Mở rộng] Số công cụ theo cấp: Từ cấp Bronze mở 39 công cụ (hồ sơ full) hoặc 29 (hồ sơ research); bộ 58 chỉ báo kỹ thuật đầy đủ mở từ cấp Silver. Chi tiết ở phân quyền và cấp tài trợ.

10-10-2026

vnstock_quant (v0.1.3)

  • Thư viện xác thực: Ghim vnstock-auth ở bản 0.5.1, thống nhất với các thư viện thế hệ 5 khác. Không đổi cách tính.

09-10-2026

vnstock_quant (v0.1.2)

  • Giữ chỉ mục đầu vào: Kết quả chỉ báo giữ nguyên chỉ mục của bảng bạn truyền vào. Cột thời gian chỉ được dùng cho vwap và pivots.
  • Nhận cột thời gian: Với bảng dữ liệu thô, thư viện tự nhận cột thời gian và chuyển thành DatetimeIndex.
  • Gọi lớp chính gọn hơn: Các lớp chính nhập được thẳng từ vnstock_quant; thông báo lỗi rõ hơn khi thiếu cột.

08-10-2026

vnstock_quant (v0.1.1)

  • Hạn dùng bản phát hành: Thư viện kiểm tra hạn dùng của bản cài trước khi tính; thông tin hạn dùng xem ở vq.entitlement()["release"].
  • Chú thích song ngữ: Chú thích hàm của các mô-đun ta, fa, risk, portfolio, valuation có cả tiếng Việt và tiếng Anh.
  • Bản hết hạn: Bản đã hết hạn báo lỗi VNSTOCK_RELEASE_EXPIRED kèm lệnh cập nhật.

vnstock_quant (v0.1.0)

Bản phát hành đầu tiên của Vnstock Quant thế hệ 5

  • Gói cài đặt dựng sẵn: Gói nhị phân dựng sẵn (binary wheels) dùng chung cho Python 3.10 trở lên, trên macOS (Intel và Apple Silicon) và Linux x86_64/aarch64 dùng glibc 2.17 trở lên.

  • Đối chiếu chỉ báo: Kết quả 58 chỉ báo kỹ thuật được đối chiếu với TA-Lib C 0.8.1 và QuantConnect LEAN.

  • Kiểm tra tham số: Tham số nến không hợp lệ báo lỗi InvalidParameterError thay vì trả kết quả sai lệch.

  • Tái cấu trúc từ vnstock_ta sang vnstock_quant: Gộp và nâng cấp thư viện vnstock_ta sang namespace mới vnstock_quant với lõi tính toán biên dịch bằng Rust (_native.abi3.so).

  • 58 chỉ báo kỹ thuật hiệu năng cao: Tính đủ 58 chỉ báo nhanh hơn 25,9 lần so với phiên bản cũ (5.000 phiên, số đo tham khảo, đo trên máy Apple M4 (10 nhân, 16 GB RAM), một luồng, ngày 06/10/2026); lõi Rust nhả khoá GIL của Python trong lúc tính.

  • Khắc phục lỗi thuật toán: Sửa 16 chỉ báo bị sai lệch công thức trong phiên bản cũ (bao gồm CCI, KST, PSAR, Supertrend, Squeeze, OBV, MFI).

  • Giữ cú pháp gọi hàm: Lớp Indicator giữ nguyên tên 58 phương thức chỉ báo, tên và giá trị mặc định của tham số; chuyển đổi bằng cách đổi tên gói khi import. Một số chỉ báo cho số khác bản cũ, xem danh sách khác biệt.

Mô-đun Chỉ số Tài chính (FA) và Mô hình Điểm số [Mở rộng]

  • Tự tính toán 99 chỉ số tài chính: Tự động tính chỉ số từ hệ thống BCTC chuẩn hoá VAS cho 4 loại hình doanh nghiệp: phi tài chính (dn), ngân hàng (tctd), chứng khoán (ctck) và bảo hiểm (dnpnt).
  • Chuẩn hoá dòng tiền CFA: Tích hợp công thức tính toán dòng tiền tự do doanh nghiệp (FCFF) và dòng tiền tự do chủ sở hữu (FCFE).
  • Hệ thống mô hình điểm số: Bổ sung mô hình phân rã DuPont (3 và 5 nhân tố), điểm số dự báo phá sản Altman Z''-score, điểm chất lượng kinh doanh Piotroski F-score và mô hình phát hiện gian lận Beneish M-score.
  • Kiểm thử công thức: Công thức được kiểm thử trên báo cáo tài chính dựng tay theo ví dụ của giáo trình CFA. Cách tính và cách hiệu chỉnh theo chuẩn mực kế toán Việt Nam được ghi ở tài liệu từng chỉ số, để bạn tự tính lại từ báo cáo tài chính.

Mô-đun Đo lường Rủi ro và Hiệu suất (Risk) [Mở rộng]

  • 33 thước đo rủi ro chuẩn CFA: Tích hợp các hàm tính toán Sharpe, Sortino, Treynor, Information Ratio, Alpha, Omega, Ulcer Index và các biến thể VaR / CVaR (lịch sử, phân phối chuẩn, Cornish-Fisher).
  • Kiểm định đối chứng quốc tế: Toàn bộ các thước đo được đối chiếu song song với thư viện empyrical và quantstats với sai số dấu phẩy động cực nhỏ (≤ 2e-14).
  • Thước đo đặc thù cho thị trường Việt Nam: Bổ sung hệ số đo độ kém thanh khoản Amihud (risk.amihud), hệ số Beta hiệu chỉnh Dimson cho cổ phiếu thanh khoản thấp (risk.dimson_beta) và các tỷ lệ theo dõi tần suất đứng giá / chạm biên độ trần sàn (zero_return_ratio, limit_hit_ratio).

Giao diện gọi hàm JSON cho trợ lý AI

  • [Mở rộng] Chuẩn hoá JSON Schema cho AI Agent: Bổ sung hàm portfolio.schema(name) và portfolio.catalog() xuất schema tự mô tả tham số, hỗ trợ kết nối trực tiếp với các mô hình ngôn ngữ lớn (OpenAI, Claude, Antigravity) và các trợ lý tự động hoá.
  • [Mở rộng] Thực thi hàm bằng JSON: Giới thiệu hàm portfolio.call(name, **kwargs) cho phép AI kích hoạt các hàm danh mục và định giá bằng payload JSON với quy ước epoch days và phân số thập phân.
  • Chẩn đoán cấp quyền và bản build: Bổ sung hai hàm chẩn đoán chạy cục bộ vq.entitlement() và vq.build_info(), hỗ trợ theo dõi lượt dùng thử của bản Cộng đồng và kiểm tra tính toàn vẹn của lõi Rust.

06-10-2026

vnstock

Cập nhật Vnstock 4.1.1 và Vnstock 5.0.0a3

Một số nhóm dữ liệu đã được gỡ khỏi thư viện. Các hàm dưới đây không còn trả dữ liệu:

  • Giá vàng trong nước: Retail().gold() (cả source="sjc" và source="btmc"), sjc_gold_price(), btmc_goldprice(). Tỷ giá ngoại tệ Retail().exchange_rate() giữ nguyên.
  • Quỹ mở: Fund(), Market().fund, Reference().fund (danh sách quỹ, NAV, danh mục nắm giữ).
  • Riêng Vnstock 5.0.0a3: gỡ thêm Fundamental().equity(...).filing(), các chuỗi vĩ mô sản xuất công nghiệp, doanh thu bán lẻ, dân số và lao động, và lãi suất (interest_rate()) của nhóm vĩ mô.

04-10-2026

vnstock_data

Cập nhật phiên bản vnstock_data 3.3.1

Khắc phục lỗi trừ sai lượt sử dụng khi mạng chập chờn và lỗi chặn kết nối khi chạy đa tiến trình.

  • Bảo toàn hạn mức khi mạng chập chờn: Khắc phục tình trạng một yêu cầu lấy dữ liệu bị hệ thống tính trừ nhiều lần vào hạn mức tài khoản khi mạng không ổn định và máy tự động gọi lại (retry). Giờ đây, mỗi lần gọi hàm chỉ tính đúng một lượt dùng dù phải thử lại bao nhiêu lần, giúp người dùng tiết kiệm số lượt gọi xác thực tài khoản.
  • Chạy dữ liệu song song mượt mà hơn: Sửa lỗi từ chối kết nối (429 Too Many Requests) khi người dùng chạy nhiều tiến trình lấy dữ liệu cùng lúc (như dùng vnstock_pipeline). Hệ thống đã được tối ưu cơ chế xác thực, giúp việc tải dữ liệu khối lượng lớn diễn ra trơn tru.

27-09-2026

vnstock_data

Cập nhật vnstock installer GUI v3.1.3 & CLI v3.0.3

  • Cài vnstock và vnai từ kho gói Vnstock: Trình cài lấy hai gói này từ https://vnstocks.com/api/simple ngay ở bước đầu và báo lỗi rõ ràng nếu không kết nối được kho gói. Cài lại trình cài giao diện bằng lệnh pip install -U --extra-index-url https://vnstocks.com/api/simple vnstock_installer==3.1.3.
  • Hiển thị đúng theo gói tài trợ: Danh sách gói hiện cả những thư viện chưa có trong gói tài trợ của bạn, kèm cấp tài trợ cần có (Bronze có vnstock_data; Silver thêm vnstock_ta, vnstock_news; Golden và Diamond thêm vnstock_pipeline). Lệnh kiểm tra sau khi cài chỉ gồm các gói đã cài thật.
  • Chế độ dòng lệnh trên mọi hệ điều hành, kể cả Windows: vnstock-cli-installer --non-interactive cài không cần mở cửa sổ, cùng tham số với bản .run của macOS/Linux (--api-key, --venv-path, --language), hợp với trợ lý AI. Xem hướng dẫn cho Windows. Khoá lấy từ tệp đã lưu hoặc biến VNSTOCK_API_KEY; thêm --json để nhận kết quả dạng máy đọc được.
  • Sửa lỗi: gói đã bỏ chọn vẫn bị cài; lần cài đầu trong môi trường ảo mới báo lỗi nhầm dù gói đã cài xong; trên Windows không tìm thấy uv khi thư mục Scripts không nằm trong PATH.

26-09-2026

vnstock

Cập nhật phiên bản Vnstock 4.0.9

Bản này tập trung vào bảo mật và trả lại quyền kiểm soát cho bạn khi dùng Vnstock cùng trợ lý AI. Cần vnai 2.6.2 trở lên, nên hãy cập nhật cả hai gói:

Shell
pip install -U --extra-index-url https://vnstocks.com/api/simple vnstock vnai

Bảo mật

  • import vnstock không còn tự ghi tệp nào. Ở các bản trước, mỗi lần import vnstock, thư viện tự chèn một đoạn hướng dẫn vào tệp quy tắc của trợ lý AI: AGENTS.md trong dự án và mặc định cả tệp dùng chung toàn máy của Claude Code, Codex, Antigravity. Nội dung đoạn này tải từ vnstocks.com lúc ghi, nên có thể thay đổi mà bạn không hề hay biết, và bạn cũng chưa từng yêu cầu. Từ bản này:
    • Tính năng chỉ chạy khi bạn chủ động bật: enable_agent() rồi setup_agent().
    • Mặc định chỉ ghi vào AGENTS.md của dự án; tệp toàn cục chỉ được ghi khi bạn chỉ định.
    • Nội dung được đóng gói sẵn trong vnai, không tải từ máy chủ nữa.
    • Nếu máy còn đoạn cũ do bản trước để lại, thư viện chỉ in một thông báo một lần, không tự sửa gì. Muốn gỡ sạch, chạy vnstock.remove_agent_files("all").
  • Tài liệu chủ đề ghi rõ nguồn gốc. Nội dung trả về từ load_skill() mở đầu bằng dòng cho biết đây là tài liệu tải về và tải từ đâu. Tên chủ đề chỉ nhận dạng tên đơn giản, để trợ lý AI không thể dẫn lượt gọi mang API key của bạn tới địa chỉ khác. Bỏ lớp "mã hoá" XOR cho tài liệu nhà tài trợ: nó không bảo vệ được gì mà chỉ khiến bạn khó kiểm tra trợ lý AI đang đọc gì.
  • Quảng cáo không thể chạy mã. Nội dung quảng bá hiển thị trong Jupyter được lọc bỏ script, frame, trình xử lý sự kiện và liên kết javascript:; văn bản trong terminal được lọc ký tự điều khiển. Khi đầu ra đang bị ghi lại (ví dụ trợ lý AI chạy lệnh), thư viện chỉ hiện nội dung đóng gói sẵn, không hiện nội dung từ máy chủ.
  • register_user() nhập API key ở chế độ ẩn, không còn hiện key trên màn hình hay lưu lại trong đầu ra của notebook. Nếu biến môi trường VNSTOCK_API_KEY đã có, hàm đề nghị lưu luôn key đó. Truyền key trực tiếp làm tham số vẫn chạy nhưng không khuyến khích.

Thay đổi khác

  • Chú thích trong mã từng viết riêng cho trợ lý AI nay là tài liệu lập trình thông thường; migrate_to_sponsor() cũng thôi in dòng nhắn gửi "AI Agent".
  • migrate_to_sponsor(dry_run=True) liệt kê những thay đổi sẽ thực hiện mà không ghi tệp, và hàm trả về số tệp đã đổi.
  • setup_agent() chạy trực tiếp thay vì chạy nền, tránh trường hợp hai tiến trình cùng ghi làm lặp đoạn hướng dẫn. Tham số async_mode vẫn nhận nhưng không còn tác dụng.
  • register_user() không còn in nhầm "bạn đang dùng bản Cộng đồng" sau khi lưu key của nhà tài trợ.
  • README cập nhật lệnh cài từ kho gói Vnstock và mô tả cơ chế bật/tắt hướng dẫn cho trợ lý AI.

25-09-2026

vnstock

Đổi lệnh cài đặt vnstock và vnai

Từ phiên bản này, hai gói vnstock và vnai được cài từ kho gói của Vnstock. Lệnh cài và lệnh cập nhật cho bản Cộng đồng:

Shell
pip install -U --extra-index-url https://vnstocks.com/api/simple vnstock vnai
  • Lệnh cũ pip install -U vnstock sẽ báo Could not find a version that satisfies the requirement vnai. Thêm phần --extra-index-url như trên là cài được.
  • Phần --extra-index-url chỉ bổ sung thêm một nơi tìm gói; các thư viện khác như pandas vẫn tải từ PyPI như cũ.
  • Nhà tài trợ không cần làm gì thêm: trình cài vnstock-installer và trình cài dòng lệnh vốn đã dùng kho gói này. Khi cài lại trình cài giao diện, ghim đúng phiên bản: pip install -U --extra-index-url https://vnstocks.com/api/simple vnstock_installer==3.1.2.
  • Nhờ trợ lý AI cài hộ thì dẫn nó tới vnstocks.com/files/vibe-onboarding.md. Tệp hướng dẫn này đã có sẵn các bước cài đặt và cập nhật mới.

23-09-2026

vnstock_data

Phát hành phiên bản v3.3.1 khắc phục lỗi cài đặt từ PyPI và tình trạng chương trình đứng hàng phút khi nguồn dữ liệu ngừng phản hồi.

  • Cài đặt từ PyPI dùng được ngay: Bản v3.3.0 không khai báo ràng buộc vnstock 4.0.8 nên máy có sẵn bản cũ hơn gặp lỗi ImportError ngay ở dòng import vnstock_data. Nay trình cài đặt tự nâng đúng bản.
  • Không còn chờ vô ích khi máy chủ im lặng: Một lượt gọi tới endpoint không phản hồi trước đây ngốn hơn hai phút do thư viện tự thử lại ngầm, nay dừng sau 30 giây. Bước mở kết nối tách riêng với hạn mức 10 giây nên nguồn không truy cập được bị loại nhanh hơn hẳn.
  • Tự tạm ngừng khi một nguồn liên tục không phản hồi: Sau 3 lượt liên tiếp không nhận được hồi đáp từ cùng một máy chủ, thư viện tạm ngừng gọi tới đó 60 giây và báo lỗi tức thì, thay vì để chương trình treo hàng giờ và tiếp tục gửi yêu cầu tới máy chủ đang không phản hồi. Dùng reset_circuit() nếu muốn thử lại ngay.
  • Thông báo lỗi mạng nói đúng nguyên nhân: Trước đây mọi sự cố đều hiện cùng một câu "Không mở được kết nối tới máy chủ dữ liệu". Nay phân biệt rõ máy chủ nhận yêu cầu nhưng không trả kết quả, không phân giải được tên miền, hết giờ chờ khi mở kết nối, hay chứng chỉ bảo mật không hợp lệ, mỗi trường hợp kèm hướng xử lý riêng.
  • Bộ lọc cổ phiếu cần ít lượt gọi hơn: Insights().screener.filter() nay lấy 500 mã mỗi lượt thay vì 50, giảm số lượt gọi tới nguồn cho cùng một bộ lọc. Kết quả không còn bị cắt giữa chừng, và một bộ lọc không hợp lệ trả về rỗng thay vì làm chương trình dừng đột ngột.
  • Sửa lỗi phản hồi không đọc được: Thư viện từng khai báo chấp nhận những định dạng nén mà nó không giải nén được, khiến một số phản hồi trở về dạng thô không đọc được mà không báo lỗi gì. Nay thư viện chỉ khai báo những định dạng nó thực sự xử lý được.
  • KBS và MBK dùng chung hạ tầng truy xuất: Hai nguồn này nay cũng được hưởng cơ chế gộp kết nối, tự thử lại khi lỗi mạng và dừng gọi khi nguồn từ chối như các nguồn còn lại.

15-09-2026

vnstock

Cập nhật phiên bản Vnstock 4.0.8

Tính năng chính: tôn trọng tín hiệu từ chối của nguồn

  • Dừng gọi khi nguồn từ chối, tạm ngừng theo từng máy chủ. Khi nguồn từ chối lượt gọi hoặc báo giới hạn tần suất, thư viện nay dừng ngay thay vì thử lại, để không tạo thêm tải lên hệ thống của nguồn. Sau đó thư viện tạm ngừng gọi tới chính máy chủ đó trong một khoảng thời gian; các lượt gọi trong khoảng này báo lỗi ngay mà không mở kết nối.
  • Thời gian tạm ngừng mặc định: 60 giây khi bị giới hạn tần suất, 300 giây khi nguồn yêu cầu xác minh hoặc từ chối truy cập. Nếu máy chủ có nói rõ cần chờ bao lâu thì thư viện tôn trọng con số đó. Thời gian chờ chỉnh được qua Config; reset_circuit() xoá trạng thái tạm ngừng.
  • Nhóm lỗi mới để bắt đúng tình huống: DataSourceBlockedError cùng các lỗi cụ thể RateLimitedError, ChallengeRequiredError, AccessDeniedError, CircuitOpenError. Mỗi lỗi mang theo địa chỉ, máy chủ, mã trạng thái và thời gian chờ còn lại. Code cũ bắt except ConnectionError vẫn hoạt động bình thường.
  • Chỉ thử lại những lỗi thật sự thoáng qua. Lỗi mạng chập chờn được thử lại; lỗi do nguồn từ chối, tham số sai hay phương thức không được hỗ trợ thì hiện ra ngay với đúng thông báo gốc, thay vì bị nuốt sau nhiều lần thử vô ích.

Thay đổi cần lưu ý

  • Loại bỏ cấu hình proxy: Gỡ bỏ các tham số proxy_config, proxy_mode và proxy_list khỏi constructor của Quote, Trading, Finance, Listing, Company ở cả nguồn KBS và VCI, cùng các tiện ích proxy đi kèm. Code truyền các tham số này sẽ báo lỗi TypeError — hãy bỏ chúng đi.
  • Ngừng hỗ trợ random_agent: Tham số này không còn tác dụng (sẽ hiện cảnh báo nếu dùng); hãy bỏ nó khỏi mã của bạn.
  • RateLimitError nay là tên gọi khác của RateLimitedError: except RateLimitError vẫn chạy, nhưng lỗi này đã chuyển sang nhóm "bị nguồn từ chối" nên không còn được tự động thử lại. Lớp cũ chưa từng được ném ra ở đâu nên không có đoạn mã nào đổi hành vi.

Cải thiện

  • Đơn giản hoá tầng gửi yêu cầu trong vnstock.core.utils.client, giảm số nhánh xử lý và giúp thông báo lỗi dễ đọc hơn.
  • Bật/tắt được phần tự tạo tệp hướng dẫn cho AI: bổ sung agent_status(), disable_agent(), enable_agent() và remove_agent_files() vào API công khai. Thư viện chỉ ghi AGENTS.md trong dự án và tệp ghi nhớ toàn cục của ba công cụ được hỗ trợ; các đường dẫn cũ không còn được ghi và remove_agent_files("legacy") dọn sạch máy đã lỡ nhận chúng.
  • except VnstockError nay bắt được mọi lỗi của thư viện. Nhóm lỗi nguồn từ chối trước đó nằm ngoài cây VnstockError nên ai dùng cách bắt này sẽ bỏ lọt đúng nhóm lỗi cần xử lý nhất.

Tài liệu & giấy phép

  • Làm rõ điều kiện giấy phép trong README: bản công khai mã nguồn trên GitHub theo giấy phép riêng, miễn phí cho mục đích cá nhân, học tập và nghiên cứu. Đây không phải giấy phép nguồn mở theo chuẩn OSI; phân phối lại và mục đích thương mại cần văn bản chấp thuận từ tác giả.
  • Bổ sung phần miễn trừ trách nhiệm và điều kiện giấy phép cho bản tiếng Anh của README, trước đây chỉ có ở phần tiếng Việt.
  • Bổ sung tuyên bố Vnstock không liên kết, không được tài trợ hay chứng thực bởi bất kỳ tổ chức nào được nhắc tới trong tài liệu và mã nguồn. Vnstock cấp quyền sử dụng phần mềm, không cấp quyền sử dụng dữ liệu; điều kiện của từng nguồn do bạn tự kiểm tra và tuân thủ.
  • Bổ sung ghi chú về dữ liệu ẩn danh của môi trường chạy được ghi nhận nhằm cải thiện hiệu năng và độ ổn định.

vnstock_data

Phát hành phiên bản v3.3.0 đưa API Báo cáo tài chính trở lại đúng chuẩn v3.2.8 và khắc phục các sai lệch của dữ liệu khớp lệnh nhóm phái sinh.

  • API Báo cáo tài chính trở lại đúng chuẩn v3.2.8: Phiên bản v3.2.9 đã vô tình quay ngược về thiết kế cũ của v3.2.7, làm mất bộ tham số đã công bố ở v3.2.8. Nay toàn bộ bộ tham số chuẩn được khôi phục: com_type để chỉ định loại hình công ty, drop_empty để lược bỏ chỉ tiêu rỗng, format để chọn cấu trúc trả về ('long', 'wide', 'time_series'), và lang mặc định là tiếng Việt. Nếu bạn đã chỉnh mã nguồn theo v3.2.9, hãy đọc kỹ cảnh báo cuối mục này.

  • Nến trong phiên lấy trọn phần lịch sử nguồn còn giữ: Với các khung 1m, 5m, 15m, 30m và 1H, chỉ cần không nêu khoảng thời gian là thư viện lấy tối đa những gì nguồn còn lưu — khoảng ba năm, lùi tới 09/2023:

    Python
    Market().futures('VN30F1M').ohlcv(interval='1m')   # 180.264 nến, từ 11-09-2023
Market().equity('ACB').ohlcv(interval='1m')        # 165.745 nến, từ 11-09-2023

    Trước đây các lệnh gọi này chỉ lấy được một phần rất nhỏ: nguồn mặc định chỉ trả tối đa khoảng 18.000 nến một phút (gần 4 tháng) bất kể khoảng ngày yêu cầu, còn mã phái sinh thì bị quy đổi sang hợp đồng tháng cụ thể nên chuỗi bị cắt về đúng ngày hợp đồng đó niêm yết. Nay hàm lấy dữ liệu trong phiên tự chuyển sang nguồn có độ sâu lớn nhất và giữ nguyên mã bạn nhập. Khung 1D trở lên không đổi.

  • Khôi phục dữ liệu khớp lệnh của hợp đồng tương lai: Ở v3.2.9, gọi dữ liệu khớp lệnh cho VN30F1M trả về kết quả rỗng. Nguyên nhân là nguồn dữ liệu chỉ chấp nhận mã hợp đồng theo quy ước mới cho nhóm hàm này. Nay thư viện tự quy đổi đúng chỗ cần quy đổi và giữ nguyên mã ở chỗ không cần.

  • Sửa sai đơn vị giá khớp lệnh phái sinh: Giá từng lệnh khớp của hợp đồng tương lai bị chia cho 1.000, trả về 1.9478 thay vì 1947.8. Quy tắc quy đổi đơn vị nay thống nhất giữa dữ liệu nến và dữ liệu khớp lệnh: chỉ số và phái sinh yết bằng điểm nên giữ nguyên, chỉ cổ phiếu mới quy về nghìn đồng.

Cần điều chỉnh code

Phiên bản này có hai thay đổi phá vỡ tương thích:

  • Tham số proxy không còn tồn tại. Mã nguồn truyền proxy_config, proxy_mode hoặc proxy_list sẽ báo lỗi TypeError. Hãy bỏ các tham số này khỏi lời gọi.
  • Bộ tham số Báo cáo tài chính quay về chuẩn v3.2.8. Nếu bạn đang dùng v3.2.9 và đã chuyển sang scorecard, dropna, include_metadata hay display_mode, hãy đổi lại theo hướng dẫn nâng cấp v3.2.8. Người dùng nâng thẳng từ v3.2.8 lên v3.3.0 không cần chỉnh gì ở nhóm hàm này.

06-09-2026

vnstock_data

Phát hành phiên bản v3.2.9 khắc phục các sai lệch của dữ liệu khớp lệnh trong phiên (trades/intraday), đặc biệt với nhóm phái sinh.

  • Khối lượng khớp lệnh trở về đúng thực tế: Khắc phục tình trạng tổng khối lượng bị gấp đôi so với số liệu sở công bố.
  • Nhãn ATO/ATC chính xác hơn: Nhận diện đúng phiên ATO 08:45–09:00 của hợp đồng tương lai, đồng thời không còn gán nhầm nhãn cho các lệnh khớp liên tục. Bổ sung nhãn PLO cho mã sàn HNX.
  • Sửa lỗi giá và thời gian ở nguồn MAS: Khắc phục tình trạng chỉ trả về vài chục dòng, sai đơn vị giá và mốc thời gian nhảy về năm 1970.
  • Mặc định lấy trọn phiên cho phái sinh: Nâng giới hạn mặc định lên 100.000 bản ghi để phủ hết phiên, thay vì 1.000 bản ghi chỉ đủ chạm cụm ATC cuối phiên. Thư viện cũng tự cảnh báo khi dữ liệu trả về chưa phủ hết phiên.
  • Thêm nguồn khớp lệnh VND: Hỗ trợ cả cổ phiếu, chứng quyền và hợp đồng tương lai, cấu trúc dữ liệu đồng nhất với các nguồn còn lại.
  • Gọi mã phái sinh kiểu cũ vẫn ra dữ liệu: Các mã như VN30F1M được tự động chuyển sang mã KRX ở mọi lớp truy xuất. Bổ sung Market().future(...) bên cạnh Market().futures(...).
  • Lưu ý về nguồn VCI: Nhà cung cấp đã áp giới hạn 100 bản ghi mỗi lượt gọi cho dữ liệu khớp lệnh, nên lấy cả phiên từ VCI sẽ cần rất nhiều lượt gọi. Nếu cần dữ liệu cả phiên, hãy chọn nguồn trả đủ phiên trong ít lượt gọi hơn như KBS, MAS hoặc VND.
  • Khôi phục cây API show_api(): Cây hiển thị đầy đủ mọi nhóm tài sản kèm nguồn dữ liệu và mô tả chức năng của từng hàm.
Cần điều chỉnh code
Phiên bản này đổi nguồn mặc định của dữ liệu khớp lệnh cổ phiếu và làm số liệu khối lượng khác đi so với bản cũ. Xem hướng dẫn nâng cấp v3.2.9 để biết cần chỉnh gì.

16-08-2026

vnstock_data

Phát hành phiên bản v3.2.8 nâng cấp nhóm hàm Báo cáo tài chính, chuẩn hoá cấu trúc chỉ tiêu theo chuẩn mực kế toán VAS.

  • Đồng nhất API Báo cáo tài chính (Finance): Tất cả các nguồn cấp dữ liệu (VCI, MAS, KBS) giờ đây đã được đồng nhất về cùng một định dạng chuẩn Tidy Data (Long-form), giúp loại bỏ hoàn toàn sự thiếu nhất quán giữa các nguồn.
  • Chuẩn hoá mã định danh (Semantic ID): Áp dụng bộ Taxonomy ID chuẩn mực (ví dụ: BS_CASH_AND_PRECIOUS_METALS) làm khoá chính, giúp mã nguồn phân tích định lượng không bị gãy sụp đổ khi tên hiển thị của chỉ tiêu thay đổi.
  • Hệ thống tham số mới mạnh mẽ:
    • Thay thế tham số dropna bằng drop_empty.
    • Hỗ trợ tuỳ chỉnh linh hoạt cấu trúc dữ liệu trả về thông qua tham số format ('long', 'wide', 'time_series').
    • Thêm tham số com_type giúp hệ thống bóc tách chính xác báo cáo dựa trên loại hình công ty (Regular, Bank, Securities, Insurance) khi cơ chế nhận diện tự động không thành công.
  • Nâng cấp tài liệu & Hướng dẫn (Migration): Cung cấp bảng tham chiếu chi tiết và tài liệu hướng dẫn nâng cấp mã nguồn dành riêng cho các thay đổi của phiên bản cập nhật này.

03-08-2026

vnstock_data

Phát hành phiên bản v3.2.7 tập trung vào nâng cấp trải nghiệm truy xuất dữ liệu & vá lỗi

  • Khắc phục lỗi tham số kỳ báo cáo cho Finance module - nguồn VCI: Xử lý triệt để tình trạng dữ liệu báo cáo tài chính bị trộn lẫn. Hiện tại, khi gọi Finance(..., period='year').balance_sheet(), kết quả trả về sẽ hoàn toàn chuẩn xác theo cột năm (tránh lẫn với dữ liệu quý), giúp việc phân tích chuỗi thời gian liền mạch.
  • Tự động phân trang ở Trading module - nguồn CafeF: Nguồn CafeF trả 20 bản ghi mỗi trang. Các hàm (lịch sử giá, giao dịch khối ngoại, tự doanh, thống kê cung cầu...) nay tự gọi các trang kế tiếp để trả về đủ số bản ghi limit bạn yêu cầu. Mỗi trang là một lượt gọi tới nguồn, nên hãy đặt limit vừa đủ nhu cầu.
  • Khắc phục lỗi cắt xén dữ liệu từ Trading module - nguồn VCI: Xử lý tình trạng dữ liệu bị cắt cụt âm thầm (chỉ trả về ~100 dòng) khi gọi chuỗi thời gian dài. Giờ đây, khi bạn truyền khoảng ngày start và end, thư viện tự chia thành các lượt gọi theo giới hạn mỗi lượt của nguồn để dữ liệu không bị cắt cụt. Khoảng ngày càng dài thì càng nhiều lượt gọi, nên chỉ lấy khoảng bạn thật sự cần.

01-08-2026

vnstock_pipeline

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.

22-07-2026

vnstock_data

Phát hành vnstock_data phiên bản 3.2.6 giúp sửa lỗi và tối ưu hoá mã nguồn.

  • Sửa lỗi trích xuất thuyết minh báo cáo tài chính (Nguồn VCI): Cập nhật lại cấu trúc hàm trích xuất thuyết minh báo cáo tài chính để hàm hoạt động ổn định và trả về dữ liệu đầy đủ thay vì kết quả rỗng.

18-07-2026

vnstock_data

Phát hành vnstock_data phiên bản 3.2.5 mang đến cho bạn nhiều lựa chọn dữ liệu hơn và nâng cao độ ổn định của hệ thống.

  • Thêm nguồn dữ liệu giao dịch mới: Tích hợp thêm nguồn asean và mbk giúp bạn có thêm các lựa chọn đáng tin cậy khi phân tích dữ liệu lịch sử giao dịch.
  • Mở rộng tra cứu thông tin doanh nghiệp: Bổ sung tính năng lấy dữ liệu thông tin niêm yết từ nguồn CafeF giúp bạn dễ dàng theo dõi các thông tin quan trọng của doanh nghiệp.
  • Trải nghiệm mượt mà hơn với nguồn ASEAN: Khắc phục hoàn toàn tình trạng lỗi kết nối khi lấy dữ liệu các nhóm hàm Insight, Sector và Trading từ nguồn ASEAN.

16-07-2026

vnstock_data

Phát hành vnstock_data phiên bản 3.2.4 giúp quá trình truy xuất dữ liệu báo cáo tài chính từ nguồn KBS ổn định.

  • Dữ liệu tài chính ổn định hơn: Hệ thống giờ đây có khả năng tự động xử lý và phục hồi (fallback) khi nguồn KBS thay đổi định dạng, giảm gián đoạn khi bạn truy xuất báo cáo tài chính.

28-06-2026

vnstock_news

Phát hành vnstock_data phiên bản 3.2.3 hoàn thiện cấu trúc tin tức của công ty niêm yết và chuẩn hoá mô hình dữ liệu.

  • Chuẩn hoá mô hình dữ liệu (Unified Schema) cho Tin tức doanh nghiệp: Giao diện Reference().company('MÃ_CK').news() được chuẩn hoá hoàn toàn trên 3 nguồn vci, kbs, và cafef với chung 10 cột dữ liệu thống nhất (id, symbol, title, summary, content, publish_time, source, url, category, image_url).
  • Nâng cấp tính năng lấy tin tức chi tiết: Bổ sung tham số mode='detail' cho phép đọc nội dung chi tiết bài viết và bóc tách các link đính kèm trực tiếp từ vci và cafef.
  • Hỗ trợ tuỳ chỉnh tham số linh hoạt: Chuẩn hoá các tham số bộ lọc thời gian (start, end, length, limit) và nâng cấp khả năng truyền linh hoạt **kwargs xuống hàm của từng nguồn.

20-06-2026

vnstock_pipeline

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.

24-05-2026

vnstock_data

Phát hành vnstock_data phiên bản 3.2.0 và cập nhật đồng loạt các thư viện trong gói sponsor với những tinh chỉnh nhỏ giúp tăng tính ổn định của hệ thống.

  • Kết nối dữ liệu ASEAN (Unified UI):

    • Tích hợp luồng dữ liệu từ trung tâm phân tích của Asean Securities, mở rộng mạnh mẽ năng lực phân tích và giúp người dùng tiếp cận dữ liệu với góc nhìn đa chiều:
      • Insights: Cung cấp bộ công cụ chuyên sâu đo lường tâm lý thị trường (sentiment: breadth, heatmap, contribution), theo vết dòng tiền (flow: foreign, proprietary, active). Đào sâu phân tích cấp độ Ngành (sector) và Cổ phiếu (equity) thông qua biểu đồ Relative Rotation Graph (rrg), định giá (valuation), so sánh ngang hàng (peer_compare), và phân tích dòng lệnh (order_flow).
      • Vĩ mô & Hàng hoá (Macro): Thay thế lõi truy xuất dữ liệu Vĩ mô (Kinh tế, Tiền tệ) sang nguồn ASEAN. Bổ sung truy xuất các chỉ số toàn cầu như Lợi suất trái phiếu (bond_yield), Lãi suất Fed (fed_rate), và các rổ hàng hoá phái sinh chuẩn quốc tế trực tiếp qua Macro().global và Macro().commodity().
    • Tương thích & Ổn định:
      • Khi người dùng truy xuất các hàng hoá đặc thù của Việt Nam (VD: Vàng SJC, Thép D10, Lợn Hơi) qua tham số market="VN", hệ thống tự động fallback mượt mà về nguồn SPL cũ, đảm bảo không bị gián đoạn trải nghiệm phân tích số liệu cục bộ.
    • Trải nghiệm Phát triển: Toàn bộ các endpoints mới được dán nhãn [Experimental] khi gọi lệnh show_api(), giúp các nhà phân tích phân biệt và nắm bắt nhanh chóng kho công cụ mới này.

    Chi tiết cấu trúc API Tree (Các hàm mới & nâng cấp):

Shell
├── Insights
│   ├── equity()
│   │   ├── order_flow() -> DataFrame # Phân bổ dòng tiền chủ động
│   │   ├── order_flow_history() -> DataFrame # Lịch sử giao dịch & dòng lệnh
│   │   ├── peer_compare() -> DataFrame # So sánh với các mã cùng ngành
│   │   └── rrg() -> DataFrame # Sức mạnh tương đối (RRG)
│   ├── flow
│   │   ├── active() -> DataFrame # Dòng tiền chủ động mua/bán
│   │   ├── foreign() -> DataFrame # Giao dịch khối ngoại (FII)
│   │   └── proprietary() -> DataFrame # Giao dịch tự doanh
│   ├── sector()
│   │   ├── flow() -> DataFrame # Dòng tiền tổng hợp toàn ngành
│   │   ├── flow_intraday() -> DataFrame # Dòng tiền ngành trong ngày
│   │   ├── index_intraday() -> DataFrame # Chỉ số ngành trong ngày
│   │   ├── members() -> DataFrame # Chỉ số tài chính của các mã trong ngành
│   │   ├── rrg() -> DataFrame # Sức mạnh tương đối ngành (RRG)
│   │   └── valuation() -> DataFrame # Tỷ số định giá ngành
│   └── sentiment
│       ├── breadth() -> DataFrame # Độ rộng thị trường
│       ├── contribution() -> DataFrame # Top đóng góp điểm số
│       └── heatmap() -> DataFrame # Bản đồ nhiệt toàn thị trường
└── Macro
    ├── commodity()
    │   ├── coke() -> DataFrame # Giá Hợp đồng tương lai Than Cốc
    │   ├── corn() -> DataFrame # Giá Ngô Mỹ
    │   ├── gas() -> DataFrame # Khí tự nhiên / Xăng dầu VN
    │   ├── gold() -> DataFrame # Vàng thế giới / Vàng SJC
    │   ├── iron_ore() -> DataFrame # Quặng sắt Trung Quốc
    │   ├── listing() -> DataFrame # Danh sách hàng hoá hỗ trợ
    │   ├── oil_crude() -> DataFrame # Dầu thô WTI
    │   ├── pork() -> DataFrame # Giá Lợn Hơi VN / TQ
    │   ├── related_industry() -> DataFrame # Nhóm ngành liên quan Hàng hoá
    │   ├── related_stock() -> DataFrame # Nhóm cổ phiếu liên quan Hàng hoá
    │   ├── soybean() -> DataFrame # Giá Đậu nành Mỹ
    │   ├── steel() -> DataFrame # Thép HRC thế giới / Thép D10 VN
    │   └── sugar() -> DataFrame # Giá Đường London
    ├── currency()
    │   ├── deposit_rate() -> DataFrame # Lãi suất huy động
    │   ├── exchange_rate() -> DataFrame # Tỷ giá trung tâm
    │   ├── interbank_rate() -> DataFrame # Lãi suất liên ngân hàng
    │   ├── omo() -> DataFrame # Nghiệp vụ thị trường mở (OMO)
    │   └── policy_rate() -> DataFrame # Lãi suất điều hành
    ├── economy()
    │   ├── cpi() -> DataFrame # Chỉ số giá tiêu dùng (CPI)
    │   ├── credit() -> DataFrame # Tăng trưởng tín dụng
    │   ├── fdi() -> DataFrame # Vốn đầu tư trực tiếp nước ngoài
    │   ├── gdp() -> DataFrame # Tổng sản phẩm quốc nội (GDP)
    │   ├── import_export() -> DataFrame # Xuất nhập khẩu
    │   ├── money_supply() -> DataFrame # Cung tiền M2
    │   ├── state_budget() -> DataFrame # Thu ngân sách nhà nước
    │   └── total_investment() -> DataFrame # Tổng vốn đầu tư
    └── global
        ├── bond_yield() -> DataFrame # Lợi suất TPCP (VN / Mỹ)
        ├── fed_rate() -> DataFrame # Lãi suất Fed
        └── index() -> DataFrame # Các chỉ số thế giới (DXY, SPX...)

19-05-2026

vnstock_pipeline

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

vnstock_pipeline

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.

16-05-2026

vnstock

Cập nhật phiên bản Vnstock 4.0.3

Bổ sung

  • Giao dịch Trái phiếu: Bổ sung cấu trúc dữ liệu trái phiếu vào tầng giao diện Unified UI, đồng nhất kiến trúc với bản Mở rộng và bổ sung các hàm ohlcv, trades, quote.
  • InstrumentType Enum: Thêm phân loại định danh chứng khoán chuyên sâu để chuẩn hoá việc nhận diện các loại tài sản tài chính.

Thay đổi & Cải thiện

  • Bổ sung danh sách các chỉ số index từ HNX, UPCOM và cải thiện khả năng nhận diện symbol qua hàm get_asset_type chính xác hơn với hỗ trợ các mã index mới.
  • Dữ liệu Báo cáo Tài chính: Hỗ trợ hệ số nhân (unit_multiplier), ánh xạ nhất quán cấu trúc cột dữ liệu giữa các nguồn KBS và VCI.
  • Xử lý Nguồn dữ liệu (MSN & VCI): Xây dựng cơ chế resolve mã SecId động cho nguồn MSN để sửa lỗi truy xuất dữ liệu lịch sử; sửa lỗi kết nối nguồn VCI và kiểm tra an toàn URL khi tải danh sách mã.

vnstock_ta

Cập nhật Vnstock Data 3.1.8

  • Chuẩn hoá Báo cáo Tài chính (Unified UI):
    • Đồng bộ Schema báo cáo tài chính cho các nguồn dữ liệu (MAS, VCI), xử lý triệt để lỗi lệch cột và lẫn lộn ngôn ngữ (mixed labels) bằng hệ thống Mapping chỉ số La Mã (Roman numeral).
    • Bổ sung thông tin kỳ báo cáo (report_period) cho nguồn VCI, giúp kết quả tương thích với giao diện Unified UI.
  • Thị trường Trái phiếu (Bond Market):
    • Tích hợp lớp domain bond vào hệ thống Unified UI, mở rộng khả năng tra cứu dữ liệu thị trường trái phiếu.

Cập nhật Vnstock TA 1.0.3

Phát hành bản cập nhật Vnstock TA 1.0.3 tập trung mang lại trải nghiệm phân tích mượt mà, trực quan và tối ưu nhất cho người dùng hệ sinh thái Vnstock.

✨ Bạn có thể làm gì với bản cập nhật này?

  • Sử dụng kho chỉ báo đa dạng: Bổ sung nhóm chỉ báo Thống kê (Statistics), chỉ báo sức mạnh xu hướng (Aroon) và mở rộng đáng kể các nhóm chỉ báo Xu hướng (Trend), Biến động (Volatility).
  • Vẽ biểu đồ chuyên nghiệp với phong cách hiện đại: Hệ thống Theme mới giúp biểu đồ có giao diện hiện đại và nhất quán. Các chỉ báo phức tạp nhiều đường (như StochRSI, ADX, PVO...) giờ đây đã có chú thích (legend) và nhãn dữ liệu rõ ràng, dễ đọc.

⚡ Tối ưu trải nghiệm sử dụng

  • Cài đặt nhanh, siêu nhẹ: Thư viện đã được tối ưu và gỡ bỏ các gói phụ thuộc nặng như pyecharts, panel hướng tới loại bỏ tính năng vẽ đồ thị tương tác sau 31/8/2026. Giờ đây cài đặt vnstock_ta sẽ nhanh chóng và tốn cực ít tài nguyên.
  • Dữ liệu ổn định và nhanh chóng: Chuyển đổi toàn bộ việc lấy dữ liệu sang giao diện Unified UI của Vnstock, giúp tốc độ tính toán nhanh và độ tin cậy cao hơn.

12-05-2026

vnstock_data

Cập nhật vnstock installer GUI v3.1.2 & CLI v3.0.2

  • Nhận diện mẫu Venv: Đồng bộ cơ chế nhận diện các tên thư mục môi trường ảo phổ biến (venv, .venv, env).
  • Cảnh báo tương tác: Bổ sung hộp thoại xác nhận khi người dùng cung cấp đường dẫn không theo quy chuẩn môi trường ảo.
  • Cơ chế an toàn: Kiểm tra sự tồn tại của tệp pyvenv.cfg và các mẫu định danh venv trước khi thực hiện thao tác sửa đổi thư mục môi trường ảo bị lỗi.
  • Gợi ý đường dẫn thông minh: Tự động gợi ý thêm hậu tố .venv nếu người dùng chọn thư mục dự án làm nơi cài đặt môi trường ảo.

05-05-2026

vnstock_data (v3.1.7)

  • Bổ sung khả năng truy xuất tài liệu và báo cáo tài chính cho từng mã chứng khoán. Người dùng có thể truy xuất danh sách liên kết đến file báo cáo tài chính định dạng PDF của từng mã thông qua lập trình đơn giản.
Python
from vnstock_data import Fundamental
fun = Fundamental()
fun.equity('FPT').filing(doc_type='annual_report')
  • Tinh chỉnh chức năng hàm tiện ích show_api để hiển thị thông tin cây API trọn vẹn hơn theo từng cấp.
    • Ví dụ để xem tất cả cấu trúc bên dưới nhóm hàm Reference có thể gọi show_api('Reference')
    • Để xem chi tiết sâu hơn 1 cấp nữa, có thể sử dụng cú pháp chaining dạng show_api('Reference.equity')

02-05-2026

vnstock_data (v3.1.6)

  • Sửa lỗi xảy ra với vnstock_data/explorer/vci/listing.py", line 35, in all_symbols xung đột thư viện sau khi code bị làm rối.

01-05-2026

vnstock_data (v3.1.5)

  • Cập nhật khả năng tuỳ chỉnh điều kiện lọc cho hàm lọc dữ liệu cổ phiếu từ VCI trong giao diện hợp nhất tại lớp Insights
  • Sửa lỗi khởi tạo cấu hình kết nối trong vnstock_data/core/utils/client.py khi gọi lệnh mẫu Company(symbol='VIC', source='KBS').overview()

29-04-2026

vnstock_data (v3.1.4)

  • Cập nhật CLI Installer phiên bản 3.1.4
    • Bổ sung danh sách mapping chính xác các chỉ số index từ HNX, UPCOM để truy xuất dữ liệu lịch sử ohlcv từ VCI

27-04-2026

vnstock

Cập nhật phiên bản Vnstock 4.0

Thư viện dữ liệu

  • Sửa lỗi truy cập dữ liệu từ nguồn VCI cho các module thông tin niêm yết (Listing), thông tin công ty (Company), và thông tin BCTC (Finance). Thay thế cơ chế lấy dữ liệu từ GraphQL sang REST API mới của Vietcap.
  • Sửa lỗi tham số to_df bị thiếu gây ngừng chương trình.
  • Cập nhật Unified UI (giao diện người dùng hợp nhất): cung cấp cách thức sử dụng hệ thống class/method chuẩn hoá cho toàn thư viện, thương thích với cách đặt tên và tiêu chuẩn của bản Mở rộng đã giới thiệu trước đó.

Tiện ích

  • Cải thiện khả năng sử dụng Google Colab thuận tiện hơn khi không yêu cầu kết nối Google Drive bắt buộc.
  • Cải thiện logic phát hiện phiên bản phần mềm của hệ sinh thái vnstock đã cập nhật để không hiện lại thông báo phiền phức.
  • [Mở rộng] Tinh chỉnh lời nhắn hướng dẫn chuyển câu lệnh import sang thư viện của bản Mở rộng cho nhà tài trợ mới.

Tài liệu

  • Cập nhật Vnstock Agent Guide với các hướng dẫn mới nhất hỗ trợ chuyển đổi code sử dụng class Vnstock sẽ bị loại bỏ từ 1/9/2026 vào skill vnstock-migration-expert.

Thông báo

  • Hiển thị cảnh báo ngừng hoạt động cho lớp hàm Vnstock thường được sử dụng qua lệnh from vnstock import Vnstock sẽ kết thúc hỗ trợ vào 31/8/2026.
  • Thông báo nâng cấp đi kèm hướng dẫn chuyển đổi code sang các lớp hàm tương đương trong thư viện.
  • Agent Skills hỗ trợ việc chuyển đổi được bố sung hướng dẫn trong Vnstock Agent Guide.

23-04-2026

vnstock_data (v3.1.3)

  • Chuẩn hoá & Mở rộng Báo cáo Tài chính (Fundamental & Financial Health):
    • Mở rộng Schema tài chính với các trường dữ liệu chi tiết từ nguồn MAS.
    • Định chuẩn hóa bộ tiêu chí đánh giá cho 4 nhóm ngành: Ngân hàng, Chứng khoán, Bảo hiểm và Đa ngành theo tiêu chuẩn phân tích chung tương tự giao diện tại TCBS.
  • Hạ tầng & Tối ưu hóa (Infrastructure & Refactoring):
    • Nâng cấp các module tiện ích lõi để cải thiện hiệu năng kết nối.
  • Sửa lỗi & Ổn định hệ thống (Bug Fixes):
    • Khắc phục triệt để lỗi sai tỷ lệ giá (price scaling) cho các tài sản Chỉ số (Index) và Phái sinh (Derivative) tại module quote (nguồn KBS).
    • Sửa lỗi truy xuất dữ liệu danh sách niêm yết (listing) và báo giá (quote) cho nguồn Dukascopy.
    • Xử lý các lỗi nhỏ trong UI Registry và logic phân loại ngành giúp hệ thống hoạt động chính xác hơn.
  • Chuyển đổi giao thức dữ liệu VCI (API Migration):
    • Chuyển đổi toàn bộ quy trình lấy danh sách (Listing) và mã ngành (ICB) từ nguồn VCI từ GraphQL sang REST API để tăng độ ổn định và tốc độ phản hồi.

12-04-2026

vnstock_data

Phần mềm vnstock_data cập nhật phiên bản 3.1.0: Hoàn thiện bộ dữ liệu hợp nhất (Unified UI) và bổ sung bổ sung dữ liệu thị trường Quốc tế.

  • Thị trường Quốc tế & Crypto:

    • Tích hợp dữ liệu tiền mã hoá (Cryptocurrency) thông qua API Binance Spot (hỗ trợ dữ liệu ohlcv, order_book, intraday, quote). Khung kiến trúc được trang bị thuật toán chờ và gửi lại để duy trì kết nối khi gặp giới hạn truy vấn API.
    • Xây dựng kiến trúc Explorer cung cấp biểu đồ đa khung thời gian cho Ngoại hối (Forex), Hàng hoá (Commodity) và các chỉ số toàn cầu thông qua Dukascopy và ForexSB. Cung cấp bộ cấu hình Múi giờ gốc sang múi giờ Hệ thống (Asia/Ho_Chi_Minh).

  • Thị trường Nội địa (Unified UI):

    • Nâng cấp API cho thị trường chỉ số (Index Market): Hệ thống hỗ trợ lấy bộ dữ liệu thống kê giao dịch lịch sử của tất cả các loại chỉ số thông qua phương thức trade_history(). Hỗ trợ tên chỉ số quy chuẩn để tra lệnh.
    • Bổ sung hàm tóm tắt bức tranh tài chính tổng hợp financial_health (tổ hợp 3 bảng báo cáo tài chính và các chỉ số tài chính). Chuẩn hoá chuyển ngữ thẻ Scorecard chuyên ngành: Ngân hàng, Chứng khoán, Bảo hiểm, hỗ trợ trích lọc linh hoạt. Quy chuẩn này lấy cảm hứng từ cấu trúc báo cáo của nền tảng TCBS, giúp duy trì sự nhất quán trong bộ tiêu chí cố định trong phân tích cơ bản cho doanh nghiệp, tránh phải xử lý bộ tiêu chí không thống nhất trong các báo cáo tài chính vốn có nhiều khác biệt giữa các nguồn khác nhau. Sử dụng bộ tiêu chí này giúp người dùng hạn chế phải thay đổi code khi nguồn dữ liệu gặp sự cố hoặc phiên bản phần mềm thay đổi ảnh hưởng tới bộ tiêu chí này.

    -Nguồn mặc định cho dữ liệu tài chính của các hàm tại Unified UI được chuyển đổi từ KBS sang MAS để tăng số kỳ báo cáo tài chính lên trên 10 năm, thay vì bị giới hạn 4 kỳ mặc định của API từ KBS.

  • Tối ưu tra cứu dữ liệu Vĩ mô (Macro) và Hàng hoá: Áp dụng kỹ thuật quét lùi tự động và đắp điền dữ liệu khuyết rỗng (Forward-fill) để xử lý hoàn thiện độ trễ công bố thông tin, giảm thiểu phát sinh lỗi.

  • Cải thiện khả năng chuẩn hoá symbol nhập nhập vào hàm của CafeF để nhận diện các chỉ số chính xác VNINDEX/HOSE, HNXINDEX/HNX, UPCOMINDEX/UPCOM và VN30.

  • Tái cấu trúc chuẩn thư viện: Áp dụng chuẩn hoá, bổ sung tham số định danh nhà cung cấp source theo yêu cầu từ phiên bản.

  • Tài liệu Agent Guide:

    • Cập nhật mô tả các hàm và nguồn dữ liệu bổ sung
    • Cung cấp schema dữ liệu chuẩn hoá giúp xác định mô hình dữ liệu và xây dựng sản phẩm tin cậy hơn, giảm thiểu việc phải chạy từng đoạn code để kiểm tra cấu trúc dữ liệu.

  • Bổ sung bộ Notebook hoàn chỉnh:

    • Bổ sung bộ Notebook hoàn chỉnh về các hàm tại Unified UI và theo kiểu gọi Adapter Pattern (thay đổi tham số source kiểu cũ) phản ánh đầy đủ trạng thái mới nhất của thư viện.

07-04-2026

vnstock_data

Phát hành vnstock_data phiên bản 3.0.1 sửa các lỗi quan trọng và tinh chỉnh trải nghiệm người dùng.

  • Unified UI: Bổ sung hàm cash_flow vào giao diện hợp nhất; cập nhật mô tả cho hàm trade_history (thống kê giao dịch, giá chứng khoán trước khi pha loãng).
  • Nguồn KBS: Sửa lỗi chia điểm index cho 1000 và lỗi 502 Bad Gateway do web phân định lại cấu trúc URL; tinh chỉnh chuẩn hoá tên chỉ tiêu tài chính.
  • Nguồn MBK (Vĩ mô): Cải thiện thuật toán truy xuất dữ liệu theo tham số length và tự động forward fill để khắc phục lỗi trả về dữ liệu rỗng.
  • Nguồn SPL (Hàng hoá): Sửa lỗi truy xuất dữ liệu null sinh ra do không khớp cấu hình múi giờ.
  • Nguồn VCI: Bổ sung cơ chế tương thích pandas cho hàm map và applymap để hoạt động tốt cho tất cả phiên bản từ 2.1.0 và trước đó.

05-04-2026

vnstock

Phát hành phiên bản 3.5.0
Bản cập nhật v3.5.1 mang đến những bước tiến lớn trong trải nghiệm lập trình AI (Vibe Coding) và hỗ trợ cập nhật cấu trúc nền tảng êm ái hơn bao giờ hết.

Tính năng bổ sung nổi bật

  • Chuẩn hóa API cột dữ liệu (Module KBS): Mình đã thiết kế lại định danh tên cột dữ liệu chứng khoán nhằm khớp chính xác 100% với giao diện trên terminal của phần mềm KBS thực tế.
    • Cột total_trades 👉 volume_accumulated (tổng khối lượng)
    • Sinh thêm cột ánh xạ 👉 volume_last (khối lượng khớp lệnh lần cuối). Lưu ý cho bạn: Anh em đang phân tích DataFrame dựa vào các key trên nhớ cập nhật lại tên hàm nhé để pipeline hệ thống tiếp tục chạy ổn định.
  • [Mở rộng] Hệ thống chuyển đổi "Một chạm" (Auto Migration): Chuyển dự án từ bản Cộng đồng sang bản Mở rộng giờ đây không còn là thao tác "Find & Replace" đầy rủi ro nơm nớp lo sợ làm hỏng code. Chỉ với một hàm gọi migrate_to_sponsor(), thư viện sẽ trực tiếp sử dụng công nghệ Cây cú pháp trừu tượng (AST) rà quét và tự động chuyển đổi cấu trúc mã nguồn cũ của bạn sang nền tảng chuyên sâu một cách an toàn tuyệt đối!
  • Hệ thống Nhận diện Môi trường (Auto-Detection Guardrail): Vnstock nay trở nên tinh tế hơn bao giờ hết: Nếu nhận thấy bạn đang ở tư cách thành viên Sponsor của mình nhưng lại vô tình nhập các hàm phân tích của gói cơ bản, hệ thống sẽ tự động nhắc nhở và điều hướng để hỗ trợ bạn dùng đúng các hàm của bản Mở rộng mà bạn đã đăng ký.
  • Tối ưu hóa Vibe Coding cùng AI: Vnstock dồn tâm huyết phát triển các chỉ báo hệ thống ngầm (System Prompts) thiết kế đặc biệt dành cho các AI Agent khi phân tích mã nguồn. Giờ đây, các AI sẽ tự nhận diện rõ năng lực của API và đóng vai trò người cố vấn thay vì cố gắng tự gỡ rối hoặc rò rỉ mã lỗi. Chúng sẽ giúp bạn phân tích khi nào việc nâng cấp lên bản Mở rộng sẽ mang lại giá trị cao hơn nhiều việc cắm cúi code.

03-04-2026

vnstock_news

Phát hành vnstock_news 2.2.0: theo dõi tin tức ổn định hơn

Bản phát hành mới khắc phục nhiều lỗi trong quá trình xử lý dữ liệu và cải thiện độ ổn định khi đọc tin từ 21 trang tin tại Việt Nam.

Nâng cấp nổi bật

  • Kiến trúc hợp nhất nguồn tin: Kết hợp và tự động dự phòng chéo (fallback) giữa luồng RSS và Sitemap, giúp ứng dụng của bạn tiếp tục nhận tin mới khi một trong hai luồng gặp sự cố.
  • Trích xuất metadata linh hoạt: Tăng cường khả năng bắt chính xác Selector qua các thuộc tính linh hoạt (id, data-slot, rel) thay vì phụ thuộc mỗi thẻ class theo CSS Selector truyền thống. Chủ động trích xuất thêm thẻ Tags, Lượt xem và Chuyên mục của bài.
  • Làm sạch tự động & Xử lý thời gian:
    • Date Parser: Tự động chuẩn hoá và ép kiểu các định dạng thời gian khác nhau (như 15 phút trước, Thứ năm...) về chuẩn ISO thống nhất.
    • Spam/Media Link Filter: Rà soát và loại bỏ link nhiễu phân trang, hình ảnh, URL rác đính kèm trong RSS.

Cải tiến độ ổn định

  • Sửa dứt điểm tình trạng trả về Data nhưng cột Nội dung trống rỗng (Missing Content 100%) gây ra bởi lỗi đọc JSON.
  • Bổ sung nguồn tin mới được hỗ trợ: Bổ sung và tinh chỉnh cấu trúc CSS cho hàng loạt website tin tức mới (Tiền Phong, Người Lao Động, Thanh Niên, Znews, Dân Trí, Đầu Tư, VnEconomy).
  • Bổ sung bộ kịch bản dùng thử "All-in-one" và tái cấu trúc tài liệu ví dụ, tự động dọn dẹp kết quả xuất file vào phân vùng tĩnh /output/.
Nhấp để xem danh sách website tin tức được hỗ trợ sẵn (cập nhật 06/10/2026)
STTTên Website / BáoTên ConfigLoại HìnhRSSSitemap
1Nhân DânnhandanCơ quan TW✅✅
2Tiền PhongtienphongCơ quan TW✅✅
3VietNamNetvietnamnetBộ Ngành✅✅
4Dân TrídantriBộ Ngành✅✅
5VnExpressvnexpressBộ Ngành✅✅
6Báo Đầu TưbaodautuBộ Ngành✅✅
7Thời Báo Tài ChínhthoibaotaichinhvietnamBộ Ngành✅✅
8Thanh NiênthanhnienTổ chức TW✅✅
9Tuổi TrẻtuoitreĐịa phương✅✅
10VnEconomyvneconomyChuyên ngành✅✅
11Diễn Đàn Doanh NghiệpdddnChuyên ngành✅✅
12PetroTimespetrotimesChuyên ngành✅✅
13Znews (Tri thức)znewsChuyên ngành✅✅
14CafeFcafefTrang tin✅✅
15CafeBizcafebizTrang tin✅✅
16VietStockvietstockTrang tin✅✅
1724h24hTổng hợp✅✅
18Người Quan SátnguoiquansatTổng hợp✅✅

27-03-2026

vnstock_data

  • Cập nhật CLI Installer phiên bản 3.0.2
    • Tự động nhận diện API Key đã lưu trong môi trường thay vì yêu cầu người dùng nhập lại.
    • Tinh chỉnh thiết lập để người dùng tiện cài đặt bộ thư viện trên Google Colab, không yêu cầu bắt buộc phải kết nối Google Drive.
    • Nâng cấp cơ chế bỏ qua thông báo chuyển đổi câu lệnh import từ vnstock sang vnstock_data gây phiền phức

11-03-2026

vnstock_data

Phát hành vnstock_data 3.0.0: Thế hệ mới với Unified UI và Thị trường Quốc tế.

Phiên bản 3.0.0 không chỉ là một bản cập nhật thông thường, mà là bước chuyển mình quan trọng của hệ sinh thái Vnstock. Phiên bản này mang đến kiến trúc 7 lớp tiêu chuẩn nghiệp vụ và trải nghiệm lập trình (DX) được nâng cấp vượt trội.

  • Kiến trúc 7 Lớp & Unified UI (U2):
    • Hoàn thiện mô hình Unified UI với 7 phân vùng chức năng rõ rệt: Reference, Market, Fundamental, Analytics, Alternative, Macro, và Insights.
    • Cách tiếp cận "Vấn đề là trên hết": Bạn không còn phải lo lắng về việc dữ liệu đến từ đâu, chỉ cần tập trung vào việc bạn muốn làm gì (định giá, xem bảng giá hay tra cứu thông tin cơ bản). Chất lượng và nguồn dữ liệu tốt nhất sẽ được Vnstock khuyến nghị. Bạn có thể cá nhân hoá nguồn dữ liệu như cách lập trình cũ nếu muốn để khai thác các chức năng có sẵn nhưng ẩn sâu trong mã nguồn.
    • Bổ sung thông tin hồ sơ (profile) chi tiết cho Chứng quyền và Hợp đồng tương lai, giúp bạn nắm bắt đầy đủ thông tin sản phẩm trước khi giao dịch.
    • Tích hợp Lịch sự kiện thị trường: từ dữ liệu lịch sử (nghỉ lễ, sự cố thị trường... từ năm 2000) đến các sự kiện hiện tại và sắp diễn ra.
  • Trợ lý lập trình thông minh (Next-Gen DX):
    • Tái kích hoạt tính năng Autocomplete và Docstring vượt trội trên các IDE (VSCode, PyCharm), giúp việc viết code nhanh và ít lỗi hơn.
    • Bổ sung bộ công cụ khám phá API: show_api() để vẽ sơ đồ thư viện ngay trong terminal và show_doc() để đọc nhanh hướng dẫn sử dụng cho từng hàm.
    • Tài liệu (Docstrings) đã được chuyển đổi sang tiếng Anh chuẩn để dễ dàng tiếp cận và phù hợp với tiêu chuẩn lập trình hiện đại và tương tác với AI Agent.
  • Chuẩn hóa & Tối ưu hóa hệ thống:
    • Chuẩn hoá dữ liệu bảng giá từ nguồn KBS: Giải quyết triệt để các vấn đề về hiển thị lô chẵn, lô lẻ; đồng bộ hóa dữ liệu cho đa dạng loại tài sản từ cổ phiếu, phái sinh, chứng quyền đến trái phiếu.
    • Dữ liệu được tự động chuẩn hóa (Normalization) từ nhiều nguồn khác nhau về một định dạng duy nhất, giúp việc tính toán và phân tích nhất quán hơn.
    • Cơ chế Lọc tham số (Kwargs Filtering): Giúp giảm thiểu lỗi runtime khi bạn vô tình truyền thừa tham số, tăng tính ổn định cho chương trình.
    • Tối ưu hóa cấu trúc nội bộ của thư viện.
  • Cập nhật Vnstock Agent Guide: Tài liệu hướng dẫn chi tiết và các quy tắc cho AI Agent trong lập trình tự động được cập nhật qua Agent Guide tại đây

07-03-2026

vnstock

Cập nhật phiên bản 3.5.0
Phiên bản 3.5.0 mang tính bản lề trong việc tái cấu trúc thư viện, tập trung loại bỏ các nguồn cấp thiếu ổn định và chuẩn hóa điểm dữ liệu để hướng tới sự tương thích với AI (Vibe Coding).

Các thay đổi quan trọng (Breaking Changes)

  • Tinh gọn các kết nối nguồn: Để bộ công cụ tinh gọn và vận hành ổn định, Vnstock ngừng các module kết nối tới TCBS và bộ lọc cổ phiếu (Screener). [Mở rộng] Bộ lọc nhiều tiêu chí khi đó có ở bản Mở rộng.
  • Chuẩn hóa Thông số Bảng giá (KBS Quote): Cập nhật định dạng dữ liệu giá lịch sử (history) và dữ liệu trong ngày (intraday) thống nhất sử dụng hệ số thập phân (đơn vị nghìn đồng) thay cho VND. Điều này giúp tính toán nhẹ nhàng hơn nhưng bạn nhớ điều chỉnh lại các công thức nhân chia mệnh giá trong dòng code cũ để tránh tình trạng lệch dữ liệu biểu đồ phân tích.
  • Loại bỏ hàm price_depth: Hàm này đã ngừng trên module vci.quote. [Mở rộng] Khi đó tính năng chỉ có ở bản Mở rộng.

Tính năng bổ sung & Cải tiến

  • Dữ liệu Sự kiện Thị trường (Market Events): Vnstock thấu hiểu nỗi đau của những ai làm backtesting khi chiến lược bị lệch pha do các ngày nghỉ lễ hay những hôm nghẽn hệ thống. Module mới vnstock.core.utils.market_events ra đời cung cấp bộ lịch sử sự kiện chứng khoán Việt Nam từ năm 2000. Đây là công cụ đắc lực hỗ trợ các mô hình AI và thuật toán phân tích chuỗi thời gian (time-series) của bạn vượt qua bài toán nhiễu loạn dữ liệu.

  • Hàng loạt Cải thiện Ổn định: Vá ngoạn mục hàng loạt lỗi hệ thống: Bổ sung phương pháp lấy mã cổ phiếu fallback cực thông minh (hiệu quả khi sàn thiếu column gốc); sửa lỗi bắt dữ liệu cho Hợp đồng tương lai đáo hạn và nâng cấp thuật toán đọc số bar trên khung ngày (500b) cho KBS Quote được chính xác. Cùng với đó là hoàn thiện việc tích hợp pytz hỗ trợ làm đồng bộ các bộ dữ liệu đa không gian múi giờ.

05-03-2026

vnstock_data

  • Cập nhật module Unified UI (U2): Cập nhật các lớp UI cung cấp cấu trúc lệnh hợp nhất với phân nhóm chặt chẽ lấy cảm hứng từ chuẩn FIX và Bloomberg Terminal giúp điều hướng dễ dàng theo mặc định do Vnstock thiết kế và người dùng không cần cài đặt nguồn dữ liệu. Tài liệu hướng dẫn chi tiết được cập nhật qua Agent Guide tại đây
  • Bổ sung hàm lấy thông tin Chứng quyền và hợp đồng tương lai:
    • Cung cấp hàm trong giao diện U2 để lấy thông tin chứng quyền và hợp đồng tương lai thông qua Reference().derivatives().warrant() và Reference().derivatives().futures()
  • Bổ sung hàm lấy thông tin bộ lọc cổ phiếu từ VCI thông qua U2 tại Insights().screener()
  • Cải thiện & bổ sung API nguồn Vĩ mô:
    • Bổ sung method interest_rate để lấy dữ liệu Lãi suất bình quân & Doanh số trên thị trường liên ngân hàng. Hỗ trợ tham số format='pivot' (mặc định) để trả về bảng dạng nhóm cột (MultiIndex giống biểu diễn trên website) hoặc format='long' để trả về định dạng phẳng (raw format).
    • Tích hợp thêm tham số khoảng thời gian tương đối length (ví dụ: 90, 1Y, 30D, 100b) tương tự như cách sử dụng trong quote.history. Tính năng này áp dụng đồng bộ cho tất cả các hàm vĩ mô (gdp, cpi, interest_rate, exchange_rate v.v...) để bỏ qua việc nhập ngày bắt đầu start và kết thúc end.
    • Thay đổi thời gian lấy dữ liệu mặc định (khi không cung cấp start, end, hoặc length) là 1 năm (1Y) để trả về thông tin ở khoảng thời gian phù hợp và nhẹ.
    • Tài liệu hướng dẫn chi tiết được cập nhật qua Agent Guide tại đây
  • Cải thiện trải nghiệm sử dụng module lấy dữ liệu hàng hoá:
    • Tích hợp khả năng lấy thời gian tương đối thông qua tham số length tương tự như module macro và quote.history.
    • Thay đổi thời gian lấy dữ liệu mặc định (khi không cung cấp start, end, hoặc length) về 1 năm (1Y) thay vì lấy toàn bộ lịch sử như trước đây.
    • Tài liệu hướng dẫn chi tiết được cập nhật qua Agent Guide tại đây

01-02-2026

vnstock

Phát hành phiên bản v3.4.2
Phiên bản 3.4.2 tập trung vào sửa lỗi và cải thiện tính ổn định, đặc biệt là tương thích với các phiên bản pandas khác nhau và chuẩn hóa dữ liệu giá.

Sửa lỗi quan trọng

  • Sửa lỗi tương thích pandas: Khắc phục vấn đề include_groups parameter không được hỗ trợ trong pandas 2.1.4, giúp hàm intraday() hoạt động bình thường trên mọi phiên bản pandas
  • Sửa lỗi kiểm thử Listing: Cập nhật các bài kiểm thử để xử lý chính xác kiểu dữ liệu pd.Series trả về từ all_future_indices và các phương thức liên quan
  • Sửa lỗi kiểm thử Quote: Cải thiện khả năng xử lý dữ liệu thiếu và các hợp đồng đã hết hạn một cách linh hoạt mà không làm thất bại toàn bộ bộ kiểm thử
  • Sửa lỗi KBS Quote: Cải thiện khả năng diễn giải các độ dài lookback dựa trên thanh (ví dụ: '500b') sử dụng logic interpret_lookback_length

Cải tiến

  • Bổ sung liên kết đến Agent Guide: Giúp dễ dàng truy cập và sử dụng bộ hướng dẫn chi tiết cho AI trong Vibe Coding.
  • Chuẩn hóa dữ liệu giá KBS: Chuyển đổi dữ liệu giá từ nguồn KBS sang sử dụng giá trị thập phân (đơn vị nghìn) thay vì VND trong các phương thức history và intraday, giúp dữ liệu nhất quán và dễ xử lý hơn

Loại bỏ

  • Loại bỏ phương thức price_depth: khỏi vnstock.explorer.vci.quote, tập trung các hàm cơ bản cho bản Cộng đồng.

31-01-2026

vnstock_data

Phát hành phiên bản 2.3.4, sửa lỗi và cải thiện trải nghiệm người dùng

  • Chuẩn hoá định dạng dữ liệu giá thành dạng thập phân xx.xx (ngàn) thay vì xxxx (đồng) cho các hàm history và intraday trong lớp Quote của nguồn dữ liệu KBS.
  • Sửa lỗi không cho phép gọi tham số length trong hàm history của lớp Quote của nguồn dữ liệu VCI, VND, MAS khi không truyền tham số start và end.
  • Sửa lỗi không nhận diện nguồn VND cho lớp hàm Market
  • Cập nhật chương trình cài đặt vnstock installer chế độ GUI và CLI sử dụng uv là công cụ quản lý thư viện thay cho pip, tăng tốc độ cài đặt và giảm 30% thời gian hoàn thành.

28-01-2026

vnstock_data

Phát hành phiên bản 2.3.2, sửa lỗi và cải thiện trải nghiệm người dùng

  • Chuẩn hoá tham số period để lấy dữ liệu báo cáo tài chính cho các phương thức trong lớp Finance của nguồn dữ liệu KBS - cho phép gọi tham số này khi khởi tạo lớp Finance thay vì gọi ở mỗi phương thức.
  • Bổ sung tham số length cho phép lấy dữ liệu hàng hoá theo cách tính thời gian tương đối so với hiện tại thay vì bắt buộc nhập ngày bắt đầu và kết thúc.
  • Tinh chỉnh nhỏ cho lớp Commodity giúp nạp thư viện chính xác, loại bỏ lỗi liên quan nested f-string sinh ra trong quá trình bảo mật mã nguồn.

27-01-2026

vnstock_data

Phát hành phiên bản 2.3.1, bổ sung tài liệu hướng dẫn chi tiết Vnstock Agent Guide.

  • Bổ sung hàm tiện ích convert_derivative_symbol giúp chuyển đổi mã hợp đồng tương lai kiểu cũ (VN30F1M) sang kiểu mới sau áp dụng KRX (tương đương 41I1G2000 tại thời điểm tháng 1/2026)
  • Cải thiện nguồn KBS
    • Sửa lỗi không nhận diện nguồn dữ liệu KBS từ Finance wrapper
    • Bổ sung khả năng lấy dữ liệu báo cáo tài chính nhiều năm thay vì cố định 4 năm như phiên bản trước
    • Tự động nhận diện và chuyển đổi mã hợp đồng tương lai sang kiểu mới để gọi các hàm history và intraday trong lớp hàm Quote.
    • Bổ sung khả năng lấy dữ liệu các mã index phổ biến HNXINDEX, HNXINDEX, UPCOMINDEX, VN30, VN100, HNX30 trong hàm history của lớp Quote.
  • Cải thiện chung
    • Hiện cảnh báo mã index không có dữ liệu intraday.

23-01-2026

vnstock

Phát hành chính thức phiên bản v3.4.0
Phiên bản 3.4.0 đã được phát hành chính thức. Cài đặt ngay với lệnh pip install vnstock -U. Phiên bản này tập trung vào trải nghiệm người dùng: dữ liệu tài chính sạch hơn, trực quan dễ hiểu hơn và cài đặt/xác thực thuận tiện hơn.

Những điểm nổi bật

  • Cài đặt & xác thực dễ dàng
    • Cài nhanh bằng pip install vnstock -U và nhập API Key từ trang quản lý tài khoản Vnstock để sử dụng, hỗ trợ hàm trực tiếp từ thư viện để sử dụng.
  • Báo cáo tài chính thân thiện với người dùng từ nguồn KBS
    • Dữ liệu báo cáo giờ đây được chuẩn hóa tốt hơn: cột rõ ràng, ít trùng lặp và dễ đọc.
    • Hỗ trợ lọc ngôn ngữ (Tiếng Việt / Tiếng Anh / Cả hai) và các chế độ hiển thị (standardized_only, all_fields, auto_convert) giúp bạn nhanh chóng lấy dữ liệu phù hợp cho báo cáo hoặc phân tích.
  • Dữ liệu đáng tin cậy & chuẩn hóa tiếng Việt
    • Cải tiến chuẩn hóa văn bản tiếng Việt (bảng ký tự nâng cấp, chuyển đổi tên trường ổn định) giúp việc tìm, so sánh và tự động hoá xử lý dữ liệu trở nên dễ dàng hơn.
    • Tự động phát hiện xung đột các trường thông tin trong BCTC và sinh ID khi cần, giảm rủi ro nhầm lẫn khi trộn nhiều nguồn dữ liệu.
    • Bổ sung khả năng truy xuất thông tin các bộ chỉ số đầu tư và chỉ số ngành từ HOSE vào Listing class, truy cập được từ mọi giá trị source.
  • Trực quan hoá & báo cáo nhanh
    • Tích hợp vnstock_ezchart cùng tiện ích mở rộng cho pandas để vẽ biểu đồ và tạo báo cáo chỉ bằng vài dòng mã.
  • Ổn định & chất lượng phát hành
    • Cải thiện quy trình kiểm thử và CI/CD giúp phát hành phiên bản ổn định hơn, lỗi được phát hiện và sửa nhanh hơn.

Một vài thay đổi nhỏ

  • Cập nhật đường dẫn đăng ký API key từ /account → /login (trải nghiệm đăng ký/đăng nhập thống nhất hơn).
  • Tối ưu hiệu suất mô-đun dữ liệu KBS và một số tinh chỉnh nội bộ để nâng cao tốc độ và độ tin cậy.

vnstock_data

  • Phát hành phiên bản 2.2.0, bổ sung kết nối nguồn KBS, dùng được trên Google Colab và Kaggle.
  • Bổ sung khả năng truy xuất thông tin các bộ chỉ số đầu tư và chỉ số ngành từ HOSE vào Listing class, truy cập được từ mọi giá trị source.
  • Cập nhật yêu cầu phiên bản gói phụ thuộc tương thích.

11-11-2025

vnstock

  • 🚀 Phiên bản v3.3.0

    • Tương thích hệ thống thư viện Sponsor sử dụng phương thức xác thực người dùng và quyền sử dụng thông qua Vnstock API key thay cho Github.
    • Tăng tốc sử dụng Vnstock trên Google Colab: Cho phép lưu trữ thư viện & cấu hình vĩnh viễn trong Google Drive để khởi động nhanh thay vì cài đặt lại sau mỗi phiên làm việc.
    • Quản lý nguồn thống nhất: Đưa các nguồn đang hỗ trợ (VCI, TCBS, FMP, XNO, DNSE) về một cơ chế quản lý chung
    • Kết nối FMP & XNO: Thêm kết nối tới hai nguồn này; bạn dùng API key của chính mình do FMP và XNO cấp
    • Tái tổ chức mã nguồn: Gộp các module trong core.utils, chuẩn hóa cách đặt tên và cấu trúc trong common
    • Bổ sung kiểm thử: Thêm bộ test cho các module VCI, TCBS, FMP với kiểm thử tích hợp
    • Chuyển sang pyproject.toml: Thay thế setup.py bằng pyproject.toml, cập nhật các thư viện phụ thuộc
    • Cấu hình Context7: Thiết lập hệ thống lập chỉ mục tài liệu cho AI
    • Cập nhật tài liệu: Làm mới notebook hướng dẫn nhanh, hướng dẫn sử dụng

  • 🔧 Cải thiện kỹ thuật

    • Chuẩn hóa hằng số thị trường, chỉ số và định nghĩa kiểu dữ liệu
    • Cải thiện xử lý lỗi và thông báo xác thực
    • Tái cấu trúc mã nguồn tiêu chuẩn với tài liệu mô tả bằng tiếng Anh

  • 📚 Tài liệu

    • Cập nhật notebook hướng dẫn nhanh cho FMP và XNO

31-08-2025

vnstock_news

Phát hành phiên bản Vnstock News 2.1.0 nâng cấp cơ chế tải dữ liệu và cung cấp khả năng tuỳ biến linh hoạt, bổ sung tài liệu hướng dẫn chi tiết.

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.

  • Thay đổi hoàn toàn cấu trúc chương trình theo hướng chặt chẽ và module hoá
  • Cung cấp cơ chế tự xử lý link sitemap và rss linh hoạt đối với các website sử dụng cơ chế động ví dụ sitemap theo năm-tháng, sitemap với số đếm tăng dần.
  • Hỗ trợ 21 trang web trong danh sách định nghĩa sẵn, người dùng có thể tự bổ sung cấu hình để theo dõi tin tức từ các trang khác ngoài danh sách.

29-08-2025

vnstock_pipeline

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ý.

21-07-2025

vnstock_data

Phát hành phiên bản Vnstock Data 2.1.3 và nâng cấp cơ chế quản lý license chính xác hơn.

Để thực hiện nâng cấp phiên bản, các bạn vui lòng chạy lại chương trình cài đặt, lưu ý nên chạy thử và trải nghiệm qua môi trường như Github Codespace để hình dung các thay đổi để không làm ảnh hưởng đến chương trình hiện có. Hệ thống không thể quay lại phiên bản cú sau nâng cấp.

Nâng cấp


Ads Free

Ẩn banner quảng cáo đối với người dùng đang duy trì gói sponsor trừ những thông báo đặc biệt liên quan đến trải nghiệm người dùng hoặc yêu cầu nâng cấp bắt buộc.

Vnstock Data Explorer

  • Bổ sung nguồn Fmarket vào mã nguồn
  • Bổ sung và nâng cấp các API của nguồn VCI
    • Thay thế API các nhóm hàm Quote, Listing class gặp lỗi từ chối truy cập và đổi url
    • Bổ sung bộ API mới cho nhóm hàm thuộc Financial class
      • Cập nhật API mới
      • Cho phép sử dụng tiếp API cũ từ máy tính local nếu muốn.
    • Sửa đổi nhóm hàm Trading cho phép lấy dữ liệu phân tích lịch sử giao dịch & bảng giá
      • Thêm các hàm foreign_trade để lấy riêng thông tin giao dịch nước ngoài
      • Loại bỏ các hàm trading_stats và side_stats trong nhóm hàm thuộc Trading class để không trùng thông tin với hàm price_board

02-06-2025

vnstock_data

Vnstock Data Explorer

Cập nhật phiên bản 2.1.2
Bổ sung hàm truy xuất dữ liệu lịch sử giao dịch từ VCI với Trading class thay thế dữ liệu từ CafeF gặp lỗi.

Chi tiết hàm bổ sung tại Nguồn VCI - Thống kê giao dịch

23-05-2025

vnstock

Cập nhật phiên bản 3.2.6
Chính thức phát hành phiên bản mới sau khi đã cập nhật bản thử nghiệm từ 17/05/2025 hỗ trợ mã hợp đồng tương lai mới sau khi chuyển đổi hệ thống KRX.

  • Hỗ trợ mã hợp đồng tương lai mới theo chuẩn KRX:

    1. Loại CK phái sinh (ký tự 1)

    2. Nhóm CK (ký tự 2: 1=Future, 2=Spread)

    3. Tài sản cơ sở (ký tự 3–4: I1=VN30, B5=GB05, BA=GB10, I2=VN100)

    4. Năm đáo hạn (ký tự 5: 0→W, loại trừ I,O,U)

    5. Tháng đáo hạn (ký tự 6: 1→C)

    6. Mã sản phẩm (ký tự 7–9, ví dụ 000 = HĐTL)

  • Ví dụ chuyển đổi: VN30F2504 → 41I1F4000

Cập nhật này giúp Vnstock nhận diện đúng loại hợp đồng tương lai khi bạn nhập mã hợp đồng theo cấu trúc mới.

07-05-2025

vnstock

Cập nhật phiên bản 3.2.5
Cập nhật mã nguồn trên Github cho phiên bản kế tiếp. Bạn có thể cập nhật phiên bản để trải nghiệm trong khi phiên bản ổn định sẽ được phát hành trong những ngày tới.

Cài đặt phiên bản thử nghiệm:

Shell
pip install vnstock -U

Xem thêm hướng dẫn tại Tải về & Cài đặt

Cập nhật nổi bật

  • Issue 164: Gỡ và thay thế một thư viện phụ thuộc bên ngoài trong toàn bộ hệ sinh thái
  • Sửa lỗi hàm intraday sau cập nhật hệ thống KRX
    • Dữ liệu từ nguồn VCI thay đổi kiểu dữ liệu (object/float) thay vì int như trước đó.
    • Dữ liệu từ nguồn TCBS bị sai lệnh múi giờ (dữ liệu mới đã chuẩn múi giờ GMT+7)
  • Bổ sung thông tin bạn đồng hành đóng góp mã nguồn và tài trợ dự án nổi bật vào mô tả dự án.

22-04-2025

vnstock

Phát hành phiên bản 3.2.4
Phiên bản **3.2.4** tái cấu trúc bộ adapter từ `vnstock/common` → `vnstock/api` với thuật toán xử lý chặt chẽ hơn, dần loại bỏ lớp trung gian không cần thiết hiện đang sử dụng với `Vnstock` class; bổ sung **notebook minh họa**; tối ưu hóa quy trình **báo lỗi** và **theo dõi dự án** trên GitHub.

Cải tiến kiến trúc

  • Bổ sung cấu trúc Adapter mới tại vnstock/api
  • Thuật toán mới tăng độ chính xác và linh hoạt khi chuyển đổi nguồn dữ liệu
  • Loại bỏ lớp trung gian cấp cao Vnstock, trực tiếp sử dụng các lớp: Quote, Finance, Trading, Listing, Company
  • Tương thích ngược: mọi hàm và class cũ vẫn hoạt động bình thường

Hướng dẫn minh họa

  • Bổ sung file notebook minh họa mới sử dụng các cấu trúc lớp trung gian chuyển đổi nguồn nhanh chóng tại đây

Hoàn thiện quy trình phát triển

vnstock_data

Vnstock Data Explorer

Phiên bản vnstock_data 2.1.0 đánh dấu bước tiến lớn trong khả năng quản lý và mở rộng dữ liệu, với việc áp dụng cấu trúc Adapter chuẩn hóa toàn bộ giao tiếp với nguồn cấp dữ liệu.

✨ Những Thay Đổi Quan Trọng
Hạng mụcThay đổi
Cấu trúc thư việnTriển khai mô hình Adapter Pattern cho tất cả các lớp dữ liệu (Quote, Trading, Finance, Listing, Company, Macro, Commodity, v.v.).
Cách gọi hàmCác hàm khi sử dụng Adapter cần truyền tham số source để xác định rõ nguồn bạn muốn truy vấn.
Mặc định sourceTham số source không còn mặc định ngầm định như phiên bản trước. Nếu không truyền source đúng, hàm có thể gây lỗi NotSupportedError.
Hướng dẫn chi tiết hơnBổ sung bảng tra cứu phương thức hỗ trợ theo nguồn cấp dữ liệu, và sơ đồ hệ thống trực quan.
🚨 Lưu Ý Ảnh Hưởng Đến Đoạn Mã Cũ

Nếu bạn đang sử dụng vnstock_data theo cách cũ

Python
from vnstock_data import Trading
trading = Trading(symbol='MSN')
quote.history(start="2024-01-01", end="2024-04-01")

➡️ Từ phiên bản 2.1.0, đoạn code trên sẽ lỗi nếu thông tin source không trùng khớp với nguồn cấp dữ liệu hỗ trợ. Cụ thể, bạn cần sửa lại thành:

Python
from vnstock_data import Trading
quote = Quote(source="cafef", symbol="VCI")
quote.history(start="2024-01-01", end="2025-04-18", interval="1D")

27-03-2025

vnstock

Cập nhật phiên bản 3.2.3 cải thiện trải nghiệm người dùng

  • Xử lý chính xác các cột có tên trùng lặp trong hàm balance_sheet trả về bảng cân đối kế toán. Theo đó cột xuất hiện sau với tên trùng lặp sẽ được đặt tên với tiền tố _. Ví dụ Chứng khoán kinh doanh và _Chứng khoán kinh doanh cho cột xuất hiện sau. Hai cột này tồn tại có ý nghĩa theo hình thức cha/con trên bảng cân đối kế toán tiêu chuẩn.
  • Merge pull request 159: Bổ sung cột sẽ được lựa chọn hiển thị tiếng Việt khi trích xuất dữ liệu từ Dict
  • Bổ sung tenacity là gói phụ thuộc khi cài đặt dự án
  • Sửa lỗi không cho truy cập dữ liệu intraday từ nguồn TCBS ngoài giờ giao dịch.
  • Sửa lỗi hàm Pandas map và thay thế với applymap để tương thích với bản Pandas cũ hơn 2.x trong module company của nguồn VCI (dòng 135)
  • Cập nhật file README đổi tên Vnstock3 thành Vnstock

24-03-2025

vnstock

Cập nhật phiên bản 3.2.2 sửa lỗi 502 Bad Request xuất hiện với nguồn dữ liệu VCI.

Lỗi 502 Bad Request xuất hiện trùng thời điểm với việc nâng cấp lên phiên bản 3.2.1 đã khiến nhiều người thắc mắc. Sau khi phân tích, nguyên nhân được xác định: VCI đã thay đổi địa chỉ cấp dữ liệu API, khiến các yêu cầu gửi đến API cũ không còn hiệu lực và dẫn đến phản hồi không ổn định.

23-03-2025

vnstock

Cập nhật phiên bản 3.2.1 với nhiều thay đổi quan trọng

  • Bổ sung tính năng bộ lọc cổ phiếu từ TCBS
  • Thêm dữ liệu thông tin công ty từ nguồn VCI
  • Kết nối Google Drive từ Colab - Không bao giờ quên lưu dữ liệu nữa
  • Cải tiến trải nghiệm người dùng
    • Nhận diện phiên giao dịch: tự động gửi cảnh báo lỗi chi tiết giúp bạn điều hướng dễ dàng khi truy cập dữ liệu intraday và price_depth trước phiên giao dịch.
    • Cảnh báo chủ động rate limit
    • Chuẩn hóa tên cột: Thay đổi ticker → symbol, HOSE → HSX, giúp dữ liệu đồng nhất, dễ xử lý hơn.
    • Cập nhật API key MSN: Đảm bảo việc lấy dữ liệu luôn ổn định và nhanh chóng.
  • Tái cấu trúc mã nguồn
    • Tăng mức độ module hóa mã nguồn
    • Cấu trúc tinh gọn và dễ bảo trì
    • Chuẩn hóa xử lý lỗi

Chi tiết, vui lòng xem trong bài blog.

02-01-2025

vnstock

Quan trọng
Hợp nhất thư viện Vnstock3 và Vnstock Legacy, sử dụng chung tên gọi thư viện là vnstock từ hệ thống phân phối phần mềm pypi.org. Từ 2/1/2025, mọi cài đặt thư viện vnstock được mặc định hiểu là thư viện thế hệ 3, bắt đầu từ phiên bản 3.1.0
  • Cập nhật thư viện lên trang phân phối pypi.org. Câu lệnh cài đặt mặc định: pip install -U vnstock sẽ luôn cài đặt phiên bản vnstock mới nhất vào máy của bạn. Câu lệnh pip install vnstock3 sẽ vẫn có hiệu lực, chỉ cập nhật đến phiên bản 3.1.0.
  • Cập nhật tài liệu hướng dẫn trên website và file Demo. Tất cả lệnh sẽ sử dụng vnstock để chỉ định phiên bản hiện tại của Vnstock3.1.0.1.

Tham khảo blog để biết thêm chi tiết tại đây.

02-11-2024

vnstock

Phát hành chính thức phiên bản v3.0.9 qua PyPI.

Cài đặt với câu lệnh: pip install -U vnstock trên máy của bạn.

  • Nâng cấp hàm truy xuất dữ liệu từ nguồn VCI cho báo cáo tài chính. Lọc các cột dữ liệu không liên quan, trùng lặp xuất hiện trong các phiên bản trước đó. Chỉ tập trung các giá trị dữ liệu cho đúng loại hình công ty của mã bạn tra cứu. Có 4 nhóm công ty bao gồm Công ty phổ thông, Ngân hàng, Chứng khoán, Bảo hiểm.
  • Sửa lỗi chuyển đổi nhanh mã cổ phiếu. Cho phép cài đặt tham số symbol khi gọi hàm với cú pháp stock.finance(symbol='TCB'). Việc này giúp bạn không cần phải cập nhật mã symbol khi khởi tạo class mà có thể thayd đổi trong method gọi dữ liệu cụ thể. Thay đổi này sau đó sẽ áp dụng cho class trong các hàm tiếp theo.
  • Bổ sung thêm tuỳ chọn tham số show_log trong các class của Vnstock, bạn có thể tắt log message (các hiển thị cảnh báo) bằng cách đặt show_log=False.
  • Khắc phục lỗi định dạng NoneType Object khi không nhập mã chứng khoán trong Listing class với câu lệnh:
from vnstock3 import Vnstock 
stock = Vnstock().stock(source='VCI')
  • Khắc phục lỗi 404 khi truy cập dữ liệu giá từ module Quote của VCI do API url thay đổi.
  • Khắc phục lỗi không nhận diện các mã chỉ số khi tra cứu lịch sử giá từ module Quote.history. Các mã chỉ số chuẩn sử dụng cho tra cứu thị trường chứng khoán Việt Nam gồm: VNINDEX, HNXINDEX, UPCOMINDEX
  • Bổ sung khả năng lấy dữ liệu giá lịch sử cho Trái phiếu niêm yết & nâng cấp cơ chế nhận diện loại tài sản với khả năng nhận diện mã nhập vào là Trái phiếu.

15-10-2024

vnstock

Cập nhật phiên bản mới, gỡ lỗi một số vấn đề phát sinh được báo lỗi: -Lỗi khi gọi lịch sử giá: issue 147

  • Bổ sung cơ chế báo lỗi khi dữ liệu trả về không như mong muốn với BCTC: issue 133

12-08-2024

vnstock

Cập nhật mã nguồn phiên bản 0.3.0.7

  • Sửa lỗi mốc thời gian giá lịch sử không ổn định. Hiện tại có thể lấy thông tin giá lịch sử thuộc tất cả các khung thời gian với tham số end là ngày hiện tại. Mã báo lỗi 135: tại đây
  • Bổ sung cơ chế xử lý lỗi khi thông tin event_desc trả về trong DataFrame không chứa thành phần HTML cần chuyển đổi thành văn bản. Mã báo lỗi 141 tại đây
  • Sửa lỗi & cải thiện phương thức lấy dữ liệu báo cáo tài chính từ VCI:
    • Sửa lỗi tên biến UNIT_MAPPING không khớp
    • Tự động loại bỏ dữ liệu N/A trong báo cáo tài chính. Việc này giúp loại bỏ các dữ liệu không có ý nghĩa và trùng lặp tên cột. Bạn có thể tuỳ chỉnh sử dụng tham số dropna=False để chỉ định giữ lại dữ liệu nguyên bản (có thể trùng lặp tên cột - khác ý nghĩa dữ liệu) và N/A.
  • Kế thừa mô-đun kết nối DNSE từ phiên bản Vnstock Legacy. Mô-đun này không còn trong thư viện hiện hành.
  • Bổ sung thông tin gói phụ thuộc
    • Bổ sung phiên bản cố định cho các gói phụ thuộc vào file requirements.txt
    • Bổ sung seaborn vào danh sách gói phụ thuộc để loại bỏ lỗi khi cài đặt trên máy tính mới không có sẵn seaborn.

10-07-2024

vnstock

Cập nhật mã nguồn phiên bản 0.3.0.6

  • Chuyển đổi mã nguồn Vnstock Legacy sang Vnstock3 cho bộ công cụ gửi tin nhắn qua Telegram, Lark, Slack tại đây.
  • Chuyển đổi mã nguồn module fund.py từ Vnstock Legacy sang Vnstock3 tại đây.
  • Loại bỏ cơ chế bắt buộc người dùng chấp nhận điều khoản, điều kiện rõ ràng. Mặc định, bạn chấp nhận điều khoản & điều kiện khi tiếp tục sử dụng Vnstock3.
  • Sửa lỗi và cải thiện trải nghiệm:
    • Xác thực thông tin mã quỹ nhập vào tại đây
    • Lỗi khi lấy giá lịch sử theo tháng tại đây

21-06-2024

vnstock

Cập nhật phiên bản 0.3.0.5

  • Sửa lỗi không hiển thị đúng múi giờ trong thời gian của bảng giá lịch sử với khung thời gian giờ và phút, chi tiết issue tại đây
  • Sửa lỗi không cho phép truy xuất thông tin giá từ TCBS nếu symbol không phải là mã cổ phiếu. Chi tiết issue tại đây
  • Bổ sung xác thực thông tin nhập liệu cho hàm history
    • Thời gian bắt đầu phải nhỏ hơn thời gian kết thúc.

03-06-2024

vnstock

Cập nhật phiên bản 0.3.0.3

  • Tích hợp khả năng vẽ biểu đồ bằng vnstock_ezchart trực tiếp vào thư viện. Chi tiết tại đây
  • Tách riêng notebook min hoạ theo chủ đề. Chi tiết tại đây
  • Cập nhật hàm truy xuất api_key từ nguồn dữ liệu MSN, khắc phục lỗi truy xuất dữ liệu các loại chứng khoán quốc tế.
  • Cập nhật nội dung phản ánh các thay đổi của dự án trên Website.

25-05-2024

vnstock

Phát hành bản cập nhật 0.3.0.2
Hoàn thiện tính năng, sửa lỗi và bổ sung tài liệu hướng dẫn.

  • Sửa lỗi tự động ghi đè thông tin mã cổ phiếu theo mã báo lỗi 9547585

  • Hoàn thiện nhóm hàm chức năng truy xuất dữ liệu tài chính. Hiện tại có thể gọi thuộc tính finance từ lớp Vnstock() thay vì gọi hàm từ trực tiếp nguồn dữ liệu kiểu vnstock3.explorer.vci.finance.

  • Cập nhật hàm minh hoạ trong Demo Notebook.

  • Bổ sung tài liệu hướng dẫn chi tiết

  • Dành cho nhóm phát triển:

    • Bổ sung cấu trúc thư mục tests dùng cho việc kiểm thử gói phần mềm.

10-05-2024

vnstock

Phát hành Vnstock3
Ra mắt phiên bản Vnstock thế hệ thứ 3 - Vnstock3.
Blog image

06-05-2024

vnstock_data

Vnstock Data Explorer

Cập nhật phiên bản 2.1.1
Cập nhật phiên bản Vnstock Data 2.1.1 sửa lỗi hàm Intraday sau khi triển khai hệ thống KRX từ 5/5/2025 và cải thiện trải nghiệm người dùng.
  • Issue 164: Gỡ một thư viện phụ thuộc bên ngoài không còn cần thiết
  • Issue 172: Bổ sung hàm price_board cho Trading class thuộc nguồn dữ liệu VCI
  • Issue 178 và sửa lỗi dữ liệu Intraday sau cập nhật hệ thống KRX cho nguồn VCI và MAS.
  • Đóng Issue 169 vì dữ liệu khung thời gian 1W đã được hỗ trợ sẵn trong thư viện.
  • Issue 166 Cập nhật thiết lập rate limit cho các nguồn dữ liệu trong gói tài trợ, tránh hiển thị nhầm thông báo nâng cấp.

02-04-2024

vnstock

Cập nhật bản 0.2.9.0
Cập nhật tài liệu hướng dẫn và sửa đổi nhỏ cho hàm gửi tin nhắn Telegram.

23-01-2024

vnstock

Phát hành phiên bản 0.2.8.8
Cập nhật thay đổi từ ngày 16/12/2023 ở phiên bản `beta` sang `main` và phát hành chính thức phiên bản 2.8.8.
  • Cập nhật mã nguồn hàm financial_report sửa lỗi triệt để lỗi sử dụng 'Excel file format cannot be determined, you must specify an engine manually' do dữ liệu trả về không phải định dạng Excel.
    • Nguồn dữ liệu từ Fiintrade của SSI sử dụng mã OrganCode để tra cứu thông tin công ty trong đó có báo cáo tài chính. Có khoảng > 600 mã cổ phiếu có mã symbol khác OrganCode do đó có nhiều mã khi tra cứu BCTC với mã symbol sẽ gây ra rỗi trong khi với các mã khác thì không. Ví dụ YTC có OrganCode là YTECO dùng để tra cứu BCTC.
    • Bổ sung openpyxl là gói phụ thuộc để đọc dữ liệu trả về từ API dưới dạng file Excel. Lỗi này xảy ra khi cài bản Python thuần. Không gặp lỗi với Google Colab hoặc Anaconda.
  • Sửa lỗi vnstock web app

vnstock

Cập nhật bản 0.2.8.8
Cập nhật thay đổi từ ngày 16/12/2023 ở phiên bản `beta` sang `main` và phát hành chính thức phiên bản 0.2.8.8.
  • Cập nhật mã nguồn hàm financial_report sửa lỗi triệt để lỗi sử dụng 'Excel file format cannot be determined, you must specify an engine manually' do dữ liệu trả về không phải định dạng Excel.
    • Nguồn dữ liệu từ Fiintrade của SSI sử dụng mã OrganCode để tra cứu thông tin công ty trong đó có báo cáo tài chính. Có khoảng > 600 mã cổ phiếu có mã symbol khác OrganCode do đó có nhiều mã khi tra cứu BCTC với mã symbol sẽ gây ra rỗi trong khi với các mã khác thì không. Ví dụ YTC có OrganCode là YTECO dùng để tra cứu BCTC.
    • Bổ sung openpyxl là gói phụ thuộc để đọc dữ liệu trả về từ API dưới dạng file Excel. Lỗi này xảy ra khi cài bản Python thuần. Không gặp lỗi với Google Colab hoặc Anaconda.
  • Sửa lỗi vnstock web app

21-01-2024

vnstock

  • Bổ sung tích hợp cho phép sử dụng các hàm gửi tin nhắn từ vnstock qua Telegram/Slack với các channel/group chat được cài đặt.
  • Cập nhật nội dung trang tài liệu
  • Khởi động dự án vnstock-next cho thế hệ phần mềm vnstock tiếp theo.

vnstock

  • Bổ sung tích hợp cho phép sử dụng các hàm gửi tin nhắn từ vnstock qua Telegram/Slack với các channel/group chat được cài đặt.
  • Cập nhật nội dung trang tài liệu
  • Khởi động dự án vnstock-next cho thế hệ phần mềm vnstock tiếp theo.

03-01-2024

vnstock

  • Cập nhật khung chương trình khóa học Python 5 khai giảng 21/1/2024

  • Bổ sung tính năng hiện banner thông báo quan trọng trên trang tài liệu.

vnstock

  • Cập nhật khung chương trình khóa học Python 5 khai giảng 21/1/2024

  • Bổ sung tính năng hiện banner thông báo quan trọng trên trang tài liệu.

02-01-2024

vnstock

  • Bổ sung tính năng OCR sử dụng Pytesseract cho vnstock và vnstock-data-pro. Chi tiết tại đây

vnstock

  • Bổ sung tính năng OCR sử dụng Pytesseract cho vnstock và vnstock-data-pro. Chi tiết tại đây

24-12-2023

vnstock

vnstock

16-12-2023

vnstock

  • Cập nhật tài liệu dự án

    • Bổ sung hướng dẫn sử dụng tích hợp SSI Fast Connect API trong gói vnstock-pro-data tại đây
    • Bổ sung thông tin chi tiết chương trình Vnstock Insider Program tại đây

  • Bổ sung requirements.txt cho trình tạo trang tĩnh MKDocs giúp cài đặt gói phụ thuộc để thiết lập trang tài liệu và xem trước dễ dàng.

vnstock

  • Cập nhật tài liệu dự án

    • Bổ sung hướng dẫn sử dụng tích hợp SSI Fast Connect API trong gói vnstock-pro-data tại đây
    • Bổ sung thông tin chi tiết chương trình Vnstock Insider Program tại đây

  • Bổ sung requirements.txt cho trình tạo trang tĩnh MKDocs giúp cài đặt gói phụ thuộc để thiết lập trang tài liệu và xem trước dễ dàng.

14-12-2023

vnstock

Chính thức phát hành các thay đổi từ nhánh Beta trong phiên bản 2.8.7. Chi tiết cập nhật qua blog: tại đây

  • Ra mắt Vnstock Insiders Program cung cấp quyền truy cập tới các kho chứa mã nguồn riêng tư (private repo)

  • Ra mắt vnstock-pro-data trong chương trình Insiders, cung cấp khả năng truy cập dữ liệu chất lượng cao với độ trễ theo nguồn.

    • Tải dữ liệu giá OHLCV nhanh chóng, chính xác không cần xác thực qua Public API của SSI.
    • Tải và streaming dữ liệu qua SSI Fast Connect API chính thức (cần đăng ký và xác thực người dùng)

  • Chính thức phát hành tính năng truy cập dữ liệu quỹ mở. Hướng dẫn tại đây

  • Hỗ trợ xuất dữ liệu time series cho OpenBB Terminal. Hướng dẫn tại đây

  • Cập nhật tài liệu dự án

vnstock

Chính thức phát hành các thay đổi từ nhánh Beta trong phiên bản 2.8.7. Chi tiết cập nhật qua blog: tại đây

  • Ra mắt Vnstock Insiders Program cung cấp quyền truy cập tới các kho chứa mã nguồn riêng tư (private repo)

  • Ra mắt vnstock-pro-data trong chương trình Insiders, cung cấp khả năng truy cập dữ liệu chất lượng cao với độ trễ theo nguồn.

    • Tải dữ liệu giá OHLCV nhanh chóng, chính xác không cần xác thực qua Public API của SSI.
    • Tải và streaming dữ liệu qua SSI Fast Connect API chính thức (cần đăng ký và xác thực người dùng)

  • Chính thức phát hành tính năng truy cập dữ liệu quỹ mở. Hướng dẫn tại đây

  • Hỗ trợ xuất dữ liệu time series cho OpenBB Terminal. Hướng dẫn tại đây

  • Cập nhật tài liệu dự án

10-12-2023

vnstock

  • Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do andrey_jef đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng.
  • Đưa plotly thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Việc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêm plotly theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới.
  • Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu giá lịch sử.
  • Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.

vnstock

  • Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do andrey_jef đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng.
  • Đưa plotly thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Việc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêm plotly theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới.
  • Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu giá lịch sử.
  • Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.

vnstock

  • Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do andrey_jef đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng.
  • Đưa plotly thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Việc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêm plotly theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới.
  • Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu giá lịch sử.
  • Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.

09-11-2023

vnstock

Phát hành phiên bản 0.2.8.5

  • Cập nhật hàm stock_intraday_data
    • Bổ sung tham số investor_segment, mặc định nhận giá trị True cho phép trả về dữ liệu khớp lệnh theo phân nhóm nhà đầu tư (như các phiên bản trước), khi đặt là False cho phép trả về dữ liệu thô, không gộp thông tin lệnh theo phân nhóm.
  • Bổ sung hàm amibroker_ohlc_export cho phép xuất dữ liệu sang định dạng CSV để nạp dữ liệu cho Amibroker. Chi tiết tại đây
  • Bổ sung hướng dẫn tích hợp vnstock với dự án sử dụng thư viện phân tích kỹ thuật TA-lib python. Chi tiết tại đây
  • Giới thiệu một số thư viện Backtesting trong python giúp nghiên cứu định lượng trên dữ liệu lịch sử. Chi tiết tại đây

08-11-2023

vnstock

Phát hành phiên bản 0.2.8.4

  • Tùy biến hàm stock_historical_data giúp dễ dàng sử dụng với các thư viện phân tích kỹ thuật khác trong Python.

    • Thêm tham số decor, nhận giá trị mặc định là False (không thay đổi dữ liệu trả về với cách sử dụng hiện tại của người dùng). Khi đặt decor=True, áp dụng thay tên các cột trong DataFrame trả về dưới dạng Title Case tức Open, High, Low, Close, Time, Ticker thay vì open, high, low, close, time, ticker như hiện tại đồng thời đặt cột Time là index. Việc này giảm bớt cho người dùng phải viết thêm câu lệnh khi sử dụng dữ liệu vnstock kết hợp các thư viện phân tích kỹ thuật phổ biến vốn dùng thư viện Yahoo Finance làm nguồn cấp dữ liệu.

    • Bổ sung tham số source cho phép chọn nguồn tải dữ liệu là TCBS hay DNSE. Nguồn dữ liệu TCBS cho lấy dữ liệu lịch sử theo ngày (resolution = 1D) trong thời gian dài, không hỗ trợ khung thời gian nhỏ hơn. Trong khi đó nguồn dữ liệu DNSE cho phép lấy dữ liệu với nhiều khung thời gian khác nhau, giới hạn 90 ngày gần nhất đối với dữ liệu phút, 10 năm gần nhất đối với dữ liệu ngày.

  • Cập nhật lớp kết nối nguồn TCBS

05-11-2023

vnstock

  • Tích hợp kết nối DNSE Lightspeed API (không còn trong thư viện hiện hành). Phát hành phiên bản 0.2.8.2. Sử dụng lệnh pip install -U vnstock để cập nhật phiên bản.

29-10-2023

vnstock

  • Tích hợp API endpoints cơ bản của DNSE vào vnstock
    • Demo cho các nhà đầu tư cách tạo 1 request và kết nối hệ thống DNSE để lấy JWT token
    • Demo xuất thông tin tài khoản
  • Cập nhật tài liệu sử dụng

27-10-2023

vnstock

  • Bổ sung và hoàn thiện một số hàm cho vnstock
    • Hàm listing_companies nay được cung cấp thêm khả năng lấy danh sách công ty niêm yết từ SSI/FiinTrade. Việc này giúp người dùng có thể tham chiếu mã công ty từ mã cổ phiếu để lấy thông tin trong một số trường hợp đặc biệt FiinTrade sử dụng mã này thay cho mã cổ phiếu. Ví dụ, thay vì dùng mã cổ phiếu BCM gây ra lỗi cho hàm, bạn cần sử dụng mã công ty tương ứng là BIDC
    • Hàm indices_listing cho phép liệt kê tất cả mã chỉ số hiện có trên sàn.
    • Hàm financial_ratio_compare cho phép so sánh chỉ số tài chính của một danh sách các mã cổ phiếu.

26-10-2023

vnstock

  • Khôi phục các hàm lấy dữ liệu từ nguồn SSI gồm financial_report, fr_trade_heatmap, market_top_mover sau khi nguồn SSI mở lại khả năng truy cập cho các nhóm dữ liệu này.
  • Cập nhật tài liệu sử dụng kèm theo
  • Cập nhật Demo Notebook

25-10-2023

vnstock

  • Bổ sung hướng dẫn xuất dữ liệu sang các định dạng phổ biến bao gồm CSV, Excel, và dữ liệu cho Amibroker.
  • Thử nghiệm tính năng Blog của Mkdocs Matterial cho chuyên mục Kiến thức.

21-10-2023

vnstock

  • Giới thiệu cách sử dụng vnstock trong Google Sheets với Neptyne for Google Sheets.
  • Di chuyển mục nội dung vnstock cho Google Sheets sang tab Ứng dụng & Tích hợp

20-10-2023

vnstock

  • Chuyển đổi nền tảng tài liệu từ Pretty-Docs sang MkDocs Matterial thân thiện và nhiều tính năng hữu ích hơn.

  • Cập nhật mô tả các hàm để tiện theo dõi bao gồm:

    • Xoay DataFrame kết quả trả về để có thể hiển thị đầy đủ tên các cột dữ liệu
    • Bổ sung mô tả tham số đầu vào của hàm

14-10-2023

vnstock

Phiên bản: 0.2.2: Đưa tính năng vẽ đồ thị chính thức vào phiên bản ổn định, cập nhật hàm truy xuất giá lịch sử

  • Cập nhật hàm stock_historical_data để trả về thông tin chính xác

    • Loại bỏ bước tính toán nhân chỉ số và mã phái sinh với 1000 khi trả về dữ liệu. Cách tính này làm sai lệch giá trị của chỉ số và mã phái sinh vì bản chất giá trị OHLC này khác với giá cổ phiếu.
    • Bổ sung thêm tham số beautify, đặt giá trị mặc định là True để giữ nguyên cách nhân 1000 cho giá cổ phiếu. Người dùng có thể chuyển về False để giữ nguyên giá trị OHLC dạng thập phân rút gọn.

  • Chính thức đưa các hàm vẽ đồ thị vào phiên bản chính thức của vnstock sau quá trình thử nghiệm

    • Hàm candlestick_chart cho phép vẽ đồ thị nến cùng các đường trung bình động, hỗ trợ, kháng cự cơ bản.

      candlestickcandlestick

    • Hàm bollinger_bands_chart cho phép vẽ đồ thị nến (hoặc đường) kèm các dải Bollinger Bands. Hàm này cần sử dụng kèm hàm bollinger_bands để chuyển đổi dữ liệu OHLC tiêu chuẩn sang dữ liệu Bollinger Bands.

      bollinger bandsbollinger bands

10-10-2023

vnstock

  • Hàm listing_company được điều chỉnh để hỗ trợ truy xuất danh sách mã cổ phiếu cập nhật trực tiếp qua API.
    • Bổ sung tham số live nhận giá trị True hoặc False, mặc định là False cho phép truy xuất danh sách cổ phiếu từ tệp csv lưu trữ trên Github. Cấu trúc của file dữ liệu cục bộ chứa thông tin đầy đủ hơn so với chế độ trực tiếp.
    • Loại bỏ tham số path

06-10-2023

vnstock

Thay đổi cấu trúc thư mục và tài liệu vnstock repo trên Github

  • Tái cấu trúc cây thư mục của vnstock repo trên Github
    • Chuyển toàn bộ file markdown vào thư mục docs trừ file README (Tiếng Việt).
      • Chuyển thư mục src vào bên trong thư mục docs và đổi tên thành resources. Các file ảnh đính kèm dự án được đưa vào sâu hơn 1 cấp bên trong thư mục images.
    • Đơn giản hóa nội dung file README của repo. Đưa tất cả tài liệu hướng dẫn vào vnstock docs.
    • Bổ sung cơ chế kiểm tra mã phản hồi (status_code) của API trước khi trả về dữ liệu cho hàm stock_intraday_data

05-10-2023

vnstock

vnstock docs Phiên bản 1.1 sử dụng Pretty-Docs theme

Thử nghiệm thành công và ra mắt phiên bản thử nghiệm 1.0 cho trang tài liệu vnstock docs sử dụng pretty-docs theme.

22-08-2023

vnstock

  • Cập nhật tệp dữ liệu listing_companies lên phiên bản mới nhất.
  • Cập nhật hàm financial flow
    • Thêm tham số get_all để lấy tất cả dữ liệu có sẵn hoặc chỉ dữ liệu mới nhất (5 năm hoặc 10 quý).
  • Cập nhật Demo Notebook để minh họa các thay đổi mới nhất.

24-07-2023

vnstock

  • Bắt đầu triển khai hàm truy xuất dữ liệu chứng khoán phái sinh.
  • Kết hợp một hàm sàng lọc cổ phiếu từ TCBS vào thư viện.
  • Cải thiện hàm stock_historical_data với các cập nhật sau:
    • Khi độ khung thời gian (resolution) được đặt thành 1D, cột thời gian sẽ hiển thị theo định dạng ngày YYYY-mm-dd.
    • Thêm một giá trị mới derivative cho tham số type, cho phép truy xuất dữ liệu phái sinh.
  • Các tham chiếu hàm trong tệp README đã được cấu trúc theo các tình huống sử dụng thực tế, như Phân tích Kỹ thuật, Phân tích Cơ bản, Sàng lọc Cổ phiếu, vv. Điều này giúp cho tài liệu thân thiện và có tổ chức hơn với người dùng. Phiên bản tiếng Anh của tệp README cũng đã được cập nhật để phù hợp với phiên bản tiếng Việt.

22-07-2023

vnstock

  • Bổ sung hướng dẫn vào Demo Notebook giúp người dùng xuất dữ liệu từ Google Colab ra Google Sheets.

14-07-2023

vnstock

  • Phát hành phiên bản 0.17 trên PyPI.
  • Những thay đổi trên nhánh beta sẽ được cập nhật vào nhánh main và phát hành qua PyPI hàng tháng từ bây giờ.
  • File README.md đã được cập nhật để đồng bộ hóa phiên bản tiếng Anh và tiếng Việt.
  • Hàm listing_companies dùng tệp tham chiếu listing_companies_enhanced-2023.csv đi kèm repo.
  • Hàm mới, price_depth, đã được giới thiệu để lấy giá và khối lượng giao dịch cho danh sách các cổ phiếu. Hàm này có thể được sử dụng song song với hàm price_board.

13-07-2023

vnstock

  • Phân loại các tính năng của vnstock trong file Demo Jupyter Notebook theo 5 nhóm chính:

    1. Thị trường (Market Watch)
    2. Phân tích cơ bản (Fundamental Analysis)
    3. Phân tích kỹ thuật (Technical Analysis)
    4. Lựa chọn cổ phiếu (Stock Screening)
    5. Trung tâm giao dịch (Trading Center)

  • Đã sửa lại file demo notebook để cập nhật các hàm mới.

  • Khôi phục giá đơn vị của stock_historical_data từ 1000 VND thành VND bằng cách nhân với 1000.

  • Hàm price_board đã được cập nhật.

  • Bổ sung hàm mới trong mô đun utils.py để trích xuất giá trị ngày tháng theo định dạng YYYY-mm-dd.

05-07-2023

vnstock

  • Cập nhật file README.md (áp dụng cho tiếng Việt trước).
  • Các hàm liên quan đến nguồn dữ liệu SSI không hoạt động đã bị loại bỏ.
  • Hàm financial_ratio đã được cải tiến với các cập nhật sau đây:
    • DataFrame kết quả bây giờ có cấu trúc được chuyển vị (transpose), với năm/quý đóng vai trò là chỉ mục, giúp sử dụng thuận tiện hơn.
    • Tham số is_all đã trở thành tham số phụ tùy chọn.
  • Hàm industry_analysis và stock_ls_analysis đã được cải thiện:
    • DataFrame kết quả bây giờ có cấu trúc được chuyển vị, với tên mã cổ phiếu làm tiêu đề cột, giúp dễ sử dụng.
    • Thêm tham số lang, cho phép hiển thị cột DataFrame bằng nhãn tiếng Việt hoặc tiếng Anh.

29-06-2023

vnstock

  • Đã cập nhật hàm stock_intraday_data để cung cấp thêm dữ liệu chi tiết trả về bởi hàm và dễ sử dụng hơn
  • Cập nhật hàm stock_historical_data để hỗ trợ lấy dữ liệu lịch sử về các chỉ số.

22-06-2023

vnstock

  • Phát hành phiên bản 0.15 rên Pypi.
  • Giới thiệu một tính năng mới cho hàm stock_historical_data, cho phép lấy dữ liệu với nhiều độ phân giải thời gian khác nhau. Đã nâng cấp API tương ứng hỗ trợ hàm này.
    • Bao gồm tham số độ phân giải để cho phép người dùng lấy dữ liệu giá tại các khoảng thời gian 1 phút, 3 phút, 5 phút, 15 phút, 30 phút, 1 giờ hoặc 1 ngày.
    • Sửa tên cột trong bảng dữ liệu trả về từ tradingDate thành time.
  • Đã đánh dấu rõ các hàm không khả dụng cho các API liên quan tới SSI.
  • Tùy chọn mode='live' trong hàm listing_companies() đã được loại bỏ. Hàm này bây giờ chỉ đọc danh sách công ty từ tệp csv trên repo github này.
  • Cập nhật cây thư mục cho github repo, thêm thư mục dữ liệu và thêm tệp dữ liệu, thư mục demo để lưu trữ các tệp demo.

07-06-2023

vnstock

Chính thức hỗ trợ hướng dẫn sử dụng bằng tiếng Việt cho tệp thư viện thông qua file README.md, giúp thúc đẩy khả năng tiếp cận với vnstock cho người dùng Việt Nam.

20-05-2023

vnstock

  • Nhánh main dành riêng cho các cập nhật quan trọng, trong khi nhánh beta được sử dụng cho các cập nhật nhỏ. Từ bây giờ, gói PyPI sẽ phản ánh nội dung của nhánh main.
  • Hàm listing_companies() bây giờ có thể đọc danh sách công ty từ tệp csv trên repo github này hoặc từ một yêu cầu API trực tiếp.
  • Hàm stock_intraday_data() bây giờ có một giới hạn mới là 100 cho tham số page_size do TCBS thiết lập.