Vnstock Logo

Lịch sử phiên bản

Cộng đồng

Mục lục

Trang này gom thay đổi của bản Cộng đồng từ nhật ký riêng của từng thư viện, xếp theo ngày. 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 đó.

15-11-2026

vnstock

Cập nhật Vnstock 6.0.1

Bản này giúp cài khoá nguồn, mở phiên và cập nhật thư viện dễ hơn. Cách gọi các hàm lấy dữ liệu không đổi. Cần vnstock-oapi 0.1.2 trở lên; lệnh dưới đây cài cả hai.

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

Cài khoá trong một lệnh

  • vnstock keys set <nguồn> lưu khoá vào keyring rồi gọi thử nguồn một lần, nên bạn biết ngay khoá có dùng được không. Trước đây phải chạy thêm vnstock keys check.
  • Với nguồn cần mở phiên bằng OTP, vnstock keys set hỏi OTP ngay sau khoá và ghi rõ lấy mã ở đâu. Nhấn Enter để bỏ qua và mở phiên sau.
  • vnstock keys set <nguồn> chỉ hỏi những trường nguồn đó cần, và nói rõ khi nguồn chỉ cần API Key.
  • Bảng vnstock keys không gọi tới nguồn, nên giờ ghi Đã có khoá (dấu •) thay cho Sẵn sàng. Dấu ✔ chỉ hiện ở vnstock keys check, khi nguồn đã nhận khoá.
  • vnstock keys check nói rõ vấn đề và lệnh cần chạy tiếp, ví dụ khoá gõ sai, đã bị thu hồi hay là khoá thử nghiệm. Với --json, mỗi dòng lỗi có thêm error_kind, error_message, problem và fix.

Mở lại phiên khi đã có khoá

  • Phiên hết hạn thì chỉ cần mở lại, không phải gõ lại khoá: vnstock auth <nguồn> trong terminal, hoặc trong Python, notebook (Jupyter, Colab):

    Python
    from vnstock import sources
    
    sources.authenticate("tcbs")                 # hỏi OTP, không hiện khi gõ
    sources.authenticate("tcbs", otp="123456")   # hoặc truyền thẳng; OTP không được lưu
  • vnstock auth <nguồn> khi nguồn chưa có khoá: báo thiếu khoá ngay, không bắt gõ OTP trước.

  • Chạy vnstock keys set với nguồn đã có khoá: lệnh nhắc rằng chỉ cần vnstock auth <nguồn> để mở phiên.

  • Lỗi hết phiên (OtpRequiredError, LoginRequiredError) nhắc cả lệnh vnstock auth <nguồn> lẫn vnstock.sources.authenticate("<nguồn>").

Nhắc hạn đổi khoá

Có nguồn chỉ cho mỗi khoá dùng được một số ngày rồi phải tạo khoá mới. vnstock lấy ngày bạn chạy vnstock keys set <nguồn> làm ngày tạo khoá và đếm thay bạn:

  • Bảng vnstock keys ghi đổi khoá trước <ngày> (còn N ngày).
  • Từ 7 ngày trước hạn, dòng đó chuyển sang dấu ! kèm lệnh cần chạy, và vnstock keys check, vnstock doctor cũng nhắc.
  • Lời gọi dữ liệu trong Python phát cảnh báo vnstock.errors.KeyRotationWarning (mã VNSTOCK_KEY_ROTATION), mỗi lần chạy một lần. Lời gọi vẫn trả dữ liệu như thường.
  • Nguồn từ chối một khoá đã quá hạn thì lỗi nói rõ cần tạo khoá mới.

Khoá đặt trong tệp .env hay biến môi trường thì vnstock không biết ngày tạo, nên chỉ báo là không đếm được. Muốn được nhắc, cất khoá bằng vnstock keys set.

Báo có bản mới, kèm cách cập nhật

  • Trong Python, cảnh báo có bản mới ở lời gọi dữ liệu đầu tiên giờ ghi cách cập nhật: vnstock update trong terminal, hoặc lệnh pip cài vào đúng trình Python đang chạy. Trong notebook, cảnh báo ghi lệnh !<python của kernel> -m vnstock update để chạy ngay trong một ô và cập nhật đúng môi trường của kernel.
  • Các lệnh dòng lệnh như vnstock keys, vnstock tools in thêm một dòng khi có bản mới, tối đa mỗi ngày một lần. Dòng này không in khi dùng --json hay khi đầu ra không phải terminal.
  • python -m vnstock chạy được, làm cùng việc với lệnh vnstock.

Sửa lỗi

  • Câu báo lỗi chuyển từ vnstock-oapi từng bảo chạy vnstock-oapi keys set ... hoặc vnstock-oapi auth .... Giờ các câu này nhắc đúng lệnh vnstock keys set ... và vnstock auth ....
  • vnstock version và vnstock update không còn liệt kê vnstock-news trong danh sách thư viện Vnstock trên máy.

vnstock-oapi

Cập nhật vnstock-oapi 0.1.2

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

Theo dõi hạn đổi khoá

Có nguồn chỉ cho mỗi khoá dùng được một số ngày, sau đó bạn phải tạo khoá mới. Từ bản này, vnstock-oapi đếm thay bạn:

  • vnstock-oapi keys set <nguồn> ghi lại ngày cất khoá và lấy ngày đó làm ngày tạo khoá. Khoá vừa cất có đủ số ngày của nguồn. Lệnh in luôn hạn đổi khoá, ví dụ Hạn đổi khoá: 15/12/2026.
  • vnstock-oapi status có thêm mục key_rotation cho nguồn có hạn dùng khoá: valid_days (số ngày một khoá), stored_on (ngày cất), due_on (hạn đổi) và days_left (số ngày còn lại, âm khi đã quá hạn).
  • Trong Python, Source.key_rotation() trả cùng các trường đó, hoặc None khi khoá của nguồn không có hạn.
  • vnstock-oapi keys delete <nguồn> xoá luôn ngày đã ghi.

Chỉ ngày được ghi, không có khoá. Ngày nằm trong tệp key_dates.json ở thư mục trạng thái của vnstock-oapi (đổi được bằng VNSTOCK_OAPI_STATE_DIR). Khoá đặt trong tệp .env hay biến môi trường thì vnstock-oapi không thấy lúc khoá được tạo, nên chỉ báo số ngày một khoá và khoá lấy từ đâu. Muốn được đếm, cất khoá bằng vnstock-oapi keys set.

Chạy lại keys set với đúng khoá cũ cũng tính là khoá mới và bắt đầu đếm lại từ đầu.

vnstock_mcp (v1.0.0)

Bản chính thức đầu tiên cho thế hệ 6

vnstock-mcp 1.0.0 là bản chính thức của dòng 1.0, sau bốn bản thử nghiệm. Không đổi cách gọi công cụ so với 1.0.0rc4, chỉ thêm trường mới. Tài liệu: Vnstock MCP v1.

  • Cài đặt: pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock-mcp[quant]==1.0.0" "vnstock==6.0.1" "vnstock-oapi==0.1.2". Phụ thuộc: vnstock>=6.0.0,<7; phần [quant] đi cùng vnstock_quant 1.0.0.
  • Hạn dùng: bản chính thức dùng được 365 ngày; bản thử nghiệm chỉ 30 ngày.
  • Báo phiên nguồn hết hạn: status, sources và research_sources có thêm trường needs_login cùng lệnh mở lại phiên, thay vì báo nguồn vẫn dùng được. Công cụ vẫn hiện; mở lại phiên xong là gọi được ngay, không cần khởi động lại máy chủ.
  • doctor --json: mọi lệnh đọc trạng thái đều xuất được JSON.
  • Bảng rỗng nói rõ: khi nguồn trả bảng rỗng, kết quả nêu rõ điều đó kèm gợi ý kiểm lại mã, khoảng ngày và nguồn, để trợ lý AI không kết luận sai.
  • Phần giới thiệu gửi cho trợ lý AI gọn hơn: rút ngắn để ứng dụng như Claude Code không cắt mất phần trạng thái nguồn và cấp quyền.

13-11-2026

vnstock_mcp (v1.0.0rc4)

Hoàn thiện gói cài đặt 5 nền tảng và chuẩn hóa đầu ra v6

  • Phát hành gói biên dịch sẵn trên cả 5 nền tảng: Xuất bản các bản dựng wheel cho macOS Apple Silicon (arm64), macOS Intel (x86_64), Linux (x86_64 và aarch64) và Windows (x86_64) trên Python 3.10–3.13, hoạt động đồng bộ cùng vnstock 6.0.0, vnstock-oapi 0.1.1 và vnstock_quant 1.0.0.
  • Đồng nhất chuẩn dữ liệu compat="v6": Tự động kích hoạt hồ sơ đầu ra v6 của vnstock 6 trên toàn phiên làm việc (giá cổ phiếu, ETF, chứng quyền ở market_*, reference_* tính theo nghìn VND; chỉ số theo điểm; cột _percent theo điểm phần trăm; thứ tự thời gian tăng dần) và ghi rõ vnstock.compat.use("v6") khi kết xuất kịch bản Python qua research_journal.
  • Thông báo lỗi có cấu trúc và nhận diện bảng nội bộ (builtin): Trả về mã MCP_INVALID_ARGUMENT (kèm danh sách tham số hợp lệ) và MCP_CHOICE_NOT_OPEN (phân biệt rõ trường hợp thiếu khóa nguồn Open API trên máy với quyền hạn tài khoản); ghi nhận rõ nguồn gốc cho các bảng danh mục có sẵn trong vnstock 6 không gọi mạng và gắn ghi chú hướng dẫn chuyển đổi cho các bộ dữ liệu lưu từ bản 0.x trong research_datasets.

12-11-2026

vnstock_quant (v1.0.0)

Bản chính thức đầu tiên cho thế hệ 6

vnstock_quant 1.0.0 là bản chính thức của dòng 1.0, sau hai bản thử nghiệm 1.0.0rc1 và 1.0.0rc2. Tài liệu: Vnstock Quant v1; nhóm hàm nào chạy với điều kiện gì: Mức hoàn thiện.

  • Cài đặt: pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock_quant>=1.0,<2", không cần --pre. Phụ thuộc: vnstock>=6.0.0,<7 và vnstock-oapi>=0.1.1,<1.
  • Hạn dùng: bản cài dùng được một năm (release["expires_at"]); bản thử nghiệm chỉ dùng được 30 ngày.
  • Lệnh vnstock-quant (từ 1.0.0rc2): giao diện tương tác, onboard từng bước, status, doctor [--live], sources, catalog, example [--run], tools, call, telemetry, docs; chạy được bằng python -m vnstock_quant. Xem Lệnh vnstock-quant.
  • fa: dùng mẫu biểu do vnstock khai trong attrs["template"]; bản 1.0.0rc1 xếp ngân hàng và công ty chứng khoán vào mẫu doanh nghiệp khi taxonomy rút gọn. com_type nhận cả dn, tctd, ctck, dnpnt lẫn regular, bank, securities, insurance khi tải qua Dataset.load. Định giá trên bảng giá vnstock ghi là đã điều chỉnh có cảnh báo.
  • Tải dữ liệu: lịch sự kiện đọc route reference.company.events của vnstock 6.0.0. Bảng phiên không còn cảnh báo thử nghiệm; BCTC và lịch sự kiện vẫn có. Cửa sổ ba năm trống trước ngày niêm yết không còn bị báo là mã có thể sai; cả khoảng ngày không có dòng nào thì có một cảnh báo.

10-11-2026

vnstock

Phát hành Vnstock 6.0.0

Bản phát hành đầu tiên của thế hệ 6. Bạn chủ động chọn nguồn, kết nối bằng khoá Open API do chính mình đăng ký tại nguồn, và nhận bảng pandas.DataFrame đã chuẩn hoá ngay trên máy. Lớp kết nối tới nguồn là thư viện vnstock-oapi, được cài cùng vnstock.

Shell
pip install -U --extra-index-url https://vnstocks.com/api/packages "vnstock>=6.0.0,<7"

Cách làm việc mới

  • Bạn chọn nguồn cho từng lời gọi (Market("<nguồn>"), source="<nguồn>"), hoặc đặt quy tắc theo nhóm hàm bằng vnstock.sources.use(...). Thư viện không tự chọn nguồn thay bạn.
  • Khoá Open API của nguồn nằm trên máy bạn và chỉ gửi tới đúng nguồn đó. Cất khoá bằng vnstock keys set <nguồn>, kiểm tra bằng vnstock keys check, mở phiên với nguồn cần OTP bằng vnstock auth <nguồn>.
  • Thế hệ 6 không áp hạn mức lượt gọi dữ liệu.

Dữ liệu

  • Market, Reference: nến lịch sử, sổ lệnh, khớp lệnh, bảng giá, khối ngoại, tự doanh; danh sách mã, rổ chỉ số, phân ngành, sự kiện quyền, hồ sơ doanh nghiệp, ETF, trái phiếu, quỹ; tiền mã hoá, tỷ giá, hàng hoá, chỉ số quốc tế. Retail cho giá vàng bạc bán lẻ trong nước.
  • Macro: chỉ tiêu vĩ mô của 5 nền kinh tế, gom theo chủ đề, cùng một cấu trúc bảng.
  • Fundamental: ba báo cáo tài chính chuẩn hoá về cây chỉ tiêu VAS với mã chỉ tiêu cố định cho cả bốn loại hình doanh nghiệp, kèm kiểm tra đẳng thức kế toán ở mỗi lần gọi.
  • Mặc định trả bộ cột chuẩn giống nhau giữa các nguồn; columns="all" lấy thêm trường riêng của nguồn. Mỗi bảng ghi nguồn gốc dữ liệu trong df.attrs.

Chuyển từ thế hệ 5

  • Giữ tên lớp và tên hàm của thế hệ 5. Hồ sơ tương thích mặc định giữ tên cột, kiểu dữ liệu quen thuộc để mã cũ tiếp tục chạy.
  • Nhóm chưa có dữ liệu trên Open API (thuyết minh báo cáo, văn bản công bố, Insights, định giá lịch sử của chỉ số trong Analytics) báo lỗi có mã VNSTOCK_ROUTE_UNSUPPORTED, không trả bảng rỗng.
  • Việc cần làm khi nâng cấp: Hướng dẫn chuyển đổi từ thế hệ 5.

Dòng lệnh

  • vnstock mở giao diện tương tác trong terminal. vnstock doctor kiểm tra máy và gợi ý cách sửa; vnstock tools, vnstock doc <hàm> tra hàm theo nguồn, kèm cột trả về; vnstock onboard tóm tắt quy tắc gọi hàm thế hệ 6 cho trợ lý AI.

vnstock-oapi

Cập nhật vnstock-oapi 0.1.1

Sửa lỗi

  • Lời gọi tới nguồn ssi bị từ chối ở bản 0.1.0 nay chạy lại bình thường. Không cần đổi khoá hay cách gọi.

vnstock-oapi

Phát hành vnstock-oapi 0.1.0

Bản phát hành đầu tiên. vnstock-oapi cất khoá Open API trên máy bạn (keyring, tệp .env hoặc biến môi trường), mở phiên với nguồn, gọi các thao tác chung (ohlc, quote, trades…) hoặc thao tác gốc của nguồn, và đóng gói phản hồi gốc thành phong bì dữ liệu. Xem Giới thiệu.

06-11-2026

vnstock_quant (v1.0.0rc1)

Bản thử nghiệm đầu tiên cho thế hệ 6

vnstock_quant 1.0 tải dữ liệu qua vnstock 6, thế hệ đọc Open API chính thức của công ty chứng khoán bằng khoá của chính bạn. Công thức tính không đổi. Tài liệu: Vnstock Quant v1; chuyển mã cũ: Chuyển từ bản 0.5.

  • Phụ thuộc: vnstock>=6.0.0rc3,<7 (kèm vnstock-oapi) là phụ thuộc bắt buộc. vnstock chỉ được nạp khi gọi hàm tải dữ liệu.
  • Chọn nguồn: không có nguồn mặc định; mọi hàm tải nhận source, bỏ trống thì theo quy tắc vnstock.sources. fa.Dataset.load thêm price_source; prices.from_vnstock thêm events_source; risk.from_vnstock tải chỉ số tham chiếu cùng nguồn với mã.
  • Đầu vào: nhận bảng của cả hai hồ sơ cột v5 và v6 của vnstock 6; lịch sự kiện theo cột mới (event_type, ex_right_date, ratio, giá quyền mua theo nghìn đồng); khớp lệnh có side, session.
  • Chỉ số định giá tắt mặc định khi thiếu số cổ phiếu: thêm estimate_shares=True để ước từ vốn điều lệ, kèm cảnh báo. Giá đóng cửa lẻ bước giá 10 đồng (giá đã điều chỉnh) bị bỏ khỏi định giá, kèm cảnh báo.
  • prices.from_vnstock tạm tắt: bảng giá đã được nguồn điều chỉnh bị từ chối (QUANT_INPUT_DATA) thay vì điều chỉnh hai lần. prices.adjust vẫn chạy với bảng giá gốc của bạn; bảng không có trần, sàn thì chỉ kiểm bằng giá tham chiếu và không tự suy sự kiện thiếu.
  • fa: báo cáo chỉ có chỉ tiêu cấp 1 thì chỉ số cần dòng chi tiết trả MISSING_INPUT thay vì tính với 0; doanh thu công ty chứng khoán lấy từ IS_REVENUE; chỉ số cần thuyết minh trả MISSING_INPUT khi chưa có thuyết minh, không dừng cả lần tải.
  • micro: lệnh trong phiên ATO, ATC luôn không có bên chủ động, kể cả khi bảng khớp lệnh có gắn chiều; bảng không cho biết phiên thì có cảnh báo.
  • backtest: thêm 5 công cụ gọi bằng JSON (run_portfolio, sweep, walk_forward, monte_carlo, deflated_sharpe_ratio), tổng 15; run_backtest trả thêm daily_returns. Cổ tức tiền và cổ phiếu thưởng cùng ngày luôn tính cổ tức trên số cổ phiếu trước khi thưởng. Cảnh báo khi dùng biểu phí chưa xác minh và khi dùng hồ sơ vn_futures.
  • Cảnh báo: nhắc một lần mỗi tiến trình khi tải bảng mà vnstock 6 còn đánh dấu thử nghiệm (BCTC, giá theo phiên, lịch sự kiện).
  • Hạn chế: bản thử nghiệm dùng được 30 ngày. Điều kiện của từng nhóm hàm: Mức hoàn thiện.

vnstock_mcp (v1.0.0rc1)

Bản thử nghiệm đầu tiên cho thế hệ 6

  • Chạy trên vnstock 6: dữ liệu qua Open API của nguồn, bằng khoá bạn đăng ký ở từng nguồn. Mọi tool dữ liệu nhận source; bỏ trống thì theo quy tắc nguồn bạn đã lưu. Tool dữ liệu hiện theo khoá nguồn trên máy, không theo cấp. Tài liệu: Vnstock MCP v1.
  • Tính toán và chạy thử: thêm quant_backtest (một mã, danh mục, dò tham số, walk-forward, Monte Carlo, Sharpe đã hiệu chỉnh), quant_returns, quant_prices, quant_micro; các bước nối nhau bằng data và refs, đi cùng vnstock_quant 1.0.0rc1.
  • Nghiên cứu: thêm research_sources, research_import (nhập tệp CSV, Excel, Parquet, JSON trên máy), research_pdf, research_bctc, research_vas (báo cáo tài chính dạng PDF); bỏ research_normalize, research_benchmark, research_universe.
  • Dòng lệnh: lệnh onboard, status, doctor, setup, sources, tools, call, workspace, serve và giao diện tương tác khi chạy trong terminal.
  • Kết quả: thêm warnings mang cảnh báo của thư viện; lời gọi lâu báo StillRunning và lần gọi lại chờ đúng phép tính đang chạy.
  • Hạn chế: ở bản rc1 mới có bản dựng cho macOS chip Apple; bản thử nghiệm dùng được 30 ngày. Chuyển từ bản 0.5: hướng dẫn.

27-10-2026

vnstock_quant (v0.5.0)

Mô-đun mới: chạy thử chiến lược (backtest)

vnstock_quant.backtest chạy thử chiến lược trên dữ liệu giá bạn chuẩn bị, theo luật thị trường Việt Nam, trong cùng lõi Rust với các nhóm hàm khác: bảng quy tắc dùng đúng 58 chỉ báo của ta, tear sheet dùng 33 thước đo của risk, chung cây lỗi của thư viện. Tài liệu: Chạy thử chiến lược.

  • Tín hiệu: mảng [-1, 0, 1], cặp entries/exits hoặc bảng quy tắc rule_dsl dạng JSON; kiểm thiên lệch nhìn trước tương lai cho cả hàm tín hiệu và bảng quy tắc (check_causality, check_rule_dsl_causality).
  • Luật thị trường: mặc định lô 100, bước giá theo sàn, biên độ, phiên khóa trần và khóa sàn, T+2.5, thuế bán 0,1% tính riêng ngoài phí; hồ sơ phái sinh VN30F, crypto, cổ phiếu quốc tế, ngoại hối; cổ tức tiền, cổ phiếu thưởng và quyền mua trên giá gốc.
  • Khớp lệnh: chế độ vn_realistic và bốn chế độ tái tạo hành vi mặc định của backtesting.py, backtrader, vectorbt, zipline; lệnh giới hạn và lệnh dừng theo phiên, nhiều lô trong một vị thế, chốt lời từng phần, dừng lỗ động, chặn rủi ro cấp tài khoản.
  • Danh mục và chống quá khớp: run_portfolio cho nhiều mã chung một tài khoản và tái cân bằng theo tỷ trọng; sweep, walk_forward, monte_carlo, deflated_sharpe_ratio.
  • Gọi bằng JSON: catalog(), schema() và call() dùng được trực tiếp cho trợ lý AI và Vnstock MCP.
  • Lỗi: lớp lỗi mới CausalityViolationError (QUANT_CAUSALITY_VIOLATION).

Mô-đun mới: giá điều chỉnh (prices)

Chỉ số tài chính (fa)

Các chỉ số nêu sau cho số khác bản 0.4.0; những chỉ số không nhắc tới giữ nguyên. Cách tính chi tiết xem ở Chỉ số tài chính.

  • P/E, P/B, P/S, P/CF, EV/EBITDA kỳ năm: Lấy giá đóng cửa và số cổ phiếu của cùng một phiên, tại ngày định giá của quý 4 năm đó, nên dòng năm trùng dòng quý 4 và P/E bằng giá / EPS trong cùng một dòng. Bản trước lấy giá cuối năm sau nhân với số cổ phiếu của năm báo cáo: chỉ số dùng giá của một năm sau kỳ báo cáo, và thấp hơn thực tế khi có chia cổ phiếu trong năm sau. Tham số overrides={"year_valuation": ...} không còn dùng được.
  • Dòng quý 4 của chuỗi quý: Mẫu số bình quân (ROE, ROA, vòng quay, số ngày thu tiền...) là bình quân 4 điểm cuối quý như các quý khác, với điểm cuối là số cuối năm đã kiểm toán. Bản trước dùng bình quân đầu năm và cuối năm, làm chuỗi quý nhảy ở mỗi quý 4. Dòng năm không đổi.
  • Mô tả ROE trong fa.describe(): Bỏ câu nói hồ sơ vn đổi mẫu số từ năm 2022; ROE luôn chia cho vốn chủ của cổ đông công ty mẹ bình quân.
  • fa.Dataset.load() khi chưa tải được giá: thư viện cảnh báo một lần và vẫn tính các chỉ số từ báo cáo tài chính; chỉ số định giá trả MISSING_MARKET. Dùng prices=False để bỏ qua bước tải giá.

18-10-2026

vnstock_chart (v1.0.0)

Phát hành dưới tên vnstock_chart

  • Đổi tên: vnstock_ezchart thành vnstock_chart. Hai gói được cài riêng; nếu đang dùng gói cũ, xem cách chuyển sang vnstock_chart.
  • Kênh phát hành: Cài từ kho phát hành thư viện của Vnstock bằng pip install --extra-index-url https://vnstocks.com/api/packages vnstock-chart.
  • 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

  • VWAP và pivots: Đọc được cột thời gian dạng dd/mm/YYYY HH:MM và dd/mm/YYYY HH:MM:SS.
  • 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

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

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 phát hành). Phần tính toán chỉ số chuyển sang các thư viện tính toán và phân tích của Vnstock, chạy trên máy bạn theo công thức công khai.

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:

  • 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).

Dòng lệnh

  • vnstock tools thay cho vnstock api: cây các hàm của thư viện. 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 và bước tiếp theo.

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

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.0)

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

  • Thay cho vnstock_ta: vnstock_ta được gộp vào gói mới vnstock_quant với lõi tính toán biên dịch bằng Rust; lõi nhả khoá GIL của Python trong lúc tính.
  • 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.
  • Khớp định nghĩa gốc: Hiệu chỉnh 16 chỉ báo cho khớp định nghĩa gốc (bao gồm CCI, KST, PSAR, Supertrend, Squeeze, OBV, MFI); kết quả 58 chỉ báo được đối chiếu với TA-Lib 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.

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

  • Chẩn đoán bản cài: Hai hàm chạy cục bộ vq.entitlement() và vq.build_info() để xem cấp quyền và kiểm tra bản dựng 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 hàm đã được gỡ khỏi thư viện và không còn trả kết quả:

  • 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.
  • 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ô.

27-04-2026

vnstock

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

  • Giao diện hợp nhất: hệ thống lớp và hàm chuẩn hoá cho toàn thư viện, cùng cách đặt tên với bản Mở rộng. Thế hệ 5 và 6 giữ cách đặt tên này.
  • Lớp Vnstock (from vnstock import Vnstock) hiện cảnh báo ngừng hỗ trợ, kết thúc vào 31/8/2026, kèm hướng dẫn chuyển sang các lớp hàm tương đương.

05-04-2026

vnstock

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

  • Đổi tên cột: total_trades thành volume_accumulated (tổng khối lượng); thêm cột volume_last (khối lượng khớp lệnh lần cuối). Mã đọc DataFrame theo tên cột cũ cần cập nhật.

07-03-2026

vnstock

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

  • Mô-đun mới vnstock.core.utils.market_events: lịch sự kiện của thị trường chứng khoán Việt Nam từ năm 2000 (ngày nghỉ lễ, ngày giao dịch bất thường), dùng khi kiểm thử chiến lược trên chuỗi thời gian.

23-01-2026

vnstock

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

  • Báo cáo tài chính chuẩn hoá hơn: cột rõ ràng, ít trùng lặp; hỗ trợ chọn ngôn ngữ (tiếng Việt, tiếng Anh hoặc cả hai) và các chế độ hiển thị standardized_only, all_fields, auto_convert.
  • Tự phát hiện trường trùng tên trong báo cáo tài chính và sinh mã định danh khi cần.
  • Chuẩn hoá văn bản tiếng Việt ổn định hơn khi chuyển đổi tên trường.
  • Tích hợp vnstock_ezchart cùng tiện ích mở rộng cho pandas để vẽ biểu đồ và lập báo cáo bằng vài dòng mã.

11-11-2025

vnstock

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

  • Thư viện của bản Mở rộng xác thực quyền sử dụng bằng API key Vnstock.
  • Chuẩn hoá hằng số thị trường, chỉ số và định nghĩa kiểu dữ liệu; cải thiện thông báo lỗi.
  • Chuyển cấu hình đóng gói từ setup.py sang pyproject.toml.

23-05-2025

vnstock

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

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

  1. Loại chứng khoán phái sinh (ký tự 1)
  2. Nhóm chứng khoán (ký tự 2: 1 = hợp đồng tương lai, 2 = chênh lệch)
  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ợp đồng tương lai)

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

22-04-2025

vnstock

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

  • Tái cấu trúc lớp điều phối từ vnstock/common sang vnstock/api.
  • Dùng trực tiếp các lớp Quote, Finance, Trading, Listing, Company thay cho lớp trung gian Vnstock. Hàm và lớp cũ vẫn hoạt động.

27-03-2025

vnstock

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

  • balance_sheet xử lý cột trùng tên: cột xuất hiện sau được thêm tiền tố _, ví dụ Chứng khoán kinh doanh và _Chứng khoán kinh doanh. Hai cột này có quan hệ cha và con trên bảng cân đối kế toán chuẩn.

23-03-2025

vnstock

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

  • Đổi tên cột và mã sàn: ticker thành symbol, HOSE thành HSX.
  • Báo lỗi rõ ràng khi gọi intraday và price_depth trước phiên giao dịch.

02-01-2025

vnstock

Hợp nhất Vnstock3 và Vnstock Legacy

Hai thư viện dùng chung tên vnstock; từ 2/1/2025, vnstock là thư viện thế hệ 3, bắt đầu từ phiên bản 3.1.0.

02-11-2024

vnstock

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

  • Báo cáo tài chính chỉ giữ chỉ tiêu đúng loại hình doanh nghiệp của mã tra cứu, theo bốn nhóm: doanh nghiệp thông thường, ngân hàng, chứng khoán, bảo hiểm.
  • Đổi mã ngay trong hàm, ví dụ stock.finance(symbol='TCB'), không cần khởi tạo lại lớp.
  • Tham số show_log=False tắt thông báo của thư viện.
  • Nhận diện mã chỉ số VNINDEX, HNXINDEX, UPCOMINDEX khi tra lịch sử giá; nhận diện mã trái phiếu niêm yết.

12-08-2024

vnstock

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

  • Báo cáo tài chính tự loại dữ liệu N/A; đặt dropna=False để giữ nguyên bảng gốc.

03-06-2024

vnstock

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

  • Tích hợp vẽ biểu đồ bằng vnstock_ezchart trực tiếp vào thư viện.

25-05-2024

vnstock

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

  • Gọi thuộc tính finance từ lớp Vnstock() thay vì gọi hàm trực tiếp ở từng mô-đun.

10-05-2024

vnstock

Phát hành Vnstock3

Ra mắt Vnstock thế hệ thứ 3.

14-12-2023

vnstock

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

  • Ra mắt bản Mở rộng (nay là gói quyền sử dụng), cấp quyền sử dụng các thư viện mở rộng của Vnstock.
  • Kết nối SSI FastConnect API chính thức bằng tài khoản do người dùng tự đăng ký và xác thực.

10-12-2023

vnstock

  • plotly thành thư viện tuỳ chọn, chỉ cần cài khi dùng tính năng vẽ đồ thị.

09-11-2023

vnstock

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

  • stock_intraday_data thêm tham số investor_segment (mặc định True, gộp lệnh theo nhóm nhà đầu tư); đặt False để nhận bảng chưa gộp.
  • Thêm hàm amibroker_ohlc_export xuất bảng sang CSV để nạp vào Amibroker trên máy bạn.

08-11-2023

vnstock

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

  • stock_historical_data thêm tham số decor: đặt True để đổi tên cột sang dạng Open, High, Low, Close, Time, Ticker và đặt cột Time làm chỉ mục, tiện dùng với các thư viện phân tích kỹ thuật phổ biến.

27-10-2023

vnstock

  • Hàm indices_listing liệt kê các mã chỉ số.
  • Hàm financial_ratio_compare so sánh chỉ số tài chính của một danh sách mã cổ phiếu.

14-10-2023

vnstock

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

  • stock_historical_data không còn nhân 1000 với chỉ số và mã phái sinh; tham số beautify (mặc định True) giữ cách nhân 1000 cho giá cổ phiếu.
  • Đưa các hàm vẽ đồ thị vào bản ổn định: candlestick_chart (nến kèm đường trung bình, hỗ trợ, kháng cự) và bollinger_bands_chart (dùng kèm bollinger_bands).

22-08-2023

vnstock

  • Hàm financial_flow thêm tham số get_all để lấy toàn bộ chuỗi kỳ hoặc chỉ các kỳ gần nhất (5 năm hoặc 10 quý).

24-07-2023

vnstock

  • stock_historical_data thêm giá trị derivative cho tham số type để tra mã phái sinh; khung 1D hiển thị ngày theo định dạng YYYY-mm-dd.

14-07-2023

vnstock

  • Phát hành phiên bản 0.17 trên PyPI.
  • Hàm mới price_depth trả giá và khối lượng theo bước giá cho danh sách mã, dùng song song với price_board.

13-07-2023

vnstock

  • stock_historical_data trả giá theo đơn vị VND thay cho nghìn đồng.

05-07-2023

vnstock

  • financial_ratio trả bảng chuyển vị, năm hoặc quý làm chỉ mục; tham số is_all thành tuỳ chọn.
  • industry_analysis và stock_ls_analysis trả bảng chuyển vị với mã cổ phiếu làm tiêu đề cột; thêm tham số lang để chọn nhãn tiếng Việt hoặc tiếng Anh.

29-06-2023

vnstock

  • stock_historical_data tra được lịch sử của các chỉ số.

22-06-2023

vnstock

Phát hành phiên bản 0.15 trên PyPI

  • stock_historical_data thêm tham số độ phân giải: 1, 3, 5, 15, 30 phút, 1 giờ hoặc 1 ngày.
  • Đổi tên cột tradingDate thành time.

07-06-2023

vnstock

Hướng dẫn sử dụng bằng tiếng Việt trong tệp README.md.