Lịch sử phiên bản
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.
pip install -U --extra-index-url https://vnstocks.com/api/packages vnstockCà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êmvnstock keys check.- Với nguồn cần mở phiên bằng OTP,
vnstock keys sethỏ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 keyskhông gọi tới nguồn, nên giờ ghiĐã có khoá(dấu•) thay choSẵn sàng. Dấu✔chỉ hiện ởvnstock keys check, khi nguồn đã nhận khoá. vnstock keys checknó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êmerror_kind,error_message,problemvà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):Pythonfrom 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 setvới nguồn đã có khoá: lệnh nhắc rằng chỉ cầnvnstock auth <nguồn>để mở phiên. -
Lỗi hết phiên (
OtpRequiredError,LoginRequiredError) nhắc cả lệnhvnstock auth <nguồn>lẫnvnstock.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 keysghiđổ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 doctorcũ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 updatetrong 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 toolsin 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--jsonhay khi đầu ra không phải terminal. python -m vnstockchạy được, làm cùng việc với lệnhvnstock.
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ặcvnstock-oapi auth .... Giờ các câu này nhắc đúng lệnhvnstock keys set ...vàvnstock auth .... vnstock versionvàvnstock updatekhông còn liệt kêvnstock-newstrong danh sách thư viện Vnstock trên máy.
vnstock-oapi
Cập nhật vnstock-oapi 0.1.2
pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock-oapiTheo 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 statuscó thêm mụckey_rotationcho 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ặcNonekhi 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ùngvnstock_quant1.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,sourcesvàresearch_sourcescó thêm trườngneeds_logincù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_64vàaarch64) và Windows (x86_64) trên Python3.10–3.13, hoạt động đồng bộ cùngvnstock6.0.0,vnstock-oapi0.1.1vàvnstock_quant1.0.0. - Đồng nhất chuẩn dữ liệu
compat="v6": Tự động kích hoạt hồ sơ đầu rav6củavnstock6 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_percenttheo đ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 quaresearch_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 trongvnstock6 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ản0.xtrongresearch_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,<7và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,onboardtừng bước,status,doctor [--live],sources,catalog,example [--run],tools,call,telemetry,docs; chạy được bằngpython -m vnstock_quant. Xem Lệnh vnstock-quant. fa: dùng mẫu biểu dovnstockkhai trongattrs["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_typenhận cảdn,tctd,ctck,dnpntlẫnregular,bank,securities,insurancekhi tải quaDataset.load. Định giá trên bảng giávnstockghi là đã điều chỉnh có cảnh báo.- Tải dữ liệu: lịch sự kiện đọc route
reference.company.eventscủavnstock6.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.
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ằngvnstock.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ằngvnstock keys check, mở phiên với nguồn cần OTP bằngvnstock 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ế.Retailcho 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 trongdf.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ố trongAnalytics) 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
vnstockmở giao diện tương tác trong terminal.vnstock doctorkiể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 onboardtó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
ssibị 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èmvnstock-oapi) là phụ thuộc bắt buộc.vnstockchỉ đượ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ắcvnstock.sources.fa.Dataset.loadthêmprice_source;prices.from_vnstockthêmevents_source;risk.from_vnstocktả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
v5vàv6củavnstock6; 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_vnstocktạ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.adjustvẫ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_INPUTthay 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_INPUTkhi 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_backtesttrả thêmdaily_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à
vnstock6 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
vnstock6: 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ậnsource; 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ằngdatavàrefs, đi cùngvnstock_quant1.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,servevà giao diện tương tác khi chạy trong terminal. - Kết quả: thêm
warningsmang cảnh báo của thư viện; lời gọi lâu báoStillRunningvà lần gọi lại chờ đúng phép tính đang chạy. - Hạn chế: ở bản
rc1mớ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ặpentries/exitshoặc bảng quy tắcrule_dsldạ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_realisticvà 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_portfoliocho 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ùngprices=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_ezchartthànhvnstock_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(chotreemap()) vàwordcloudlà phụ thuộc tuỳ chọn, cài bằngvnstock-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 installcó đủ mọi thư mục con, không còn lỗiModuleNotFoundErrormàvnstock_ezchart1.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:MMvà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:
vwapvớianchorkhông hợp lệ báoInvalidParameterErrorbằng tiếng Việt, giốngmicro.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 toolsthay chovnstock 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ằngvnstock doc. Gõvnstock apivẫ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-mcptừ 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
vwapvà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ớivnstock_quantvớ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
Indicatorgiữ 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
InvalidParameterErrorthay 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_tradesthànhvolume_accumulated(tổng khối lượng); thêm cộtvolume_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_ezchartcù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.pysangpyproject.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:
- Loại chứng khoán phái sinh (ký tự 1)
- Nhóm chứng khoán (ký tự 2: 1 = hợp đồng tương lai, 2 = chênh lệch)
- Tài sản cơ sở (ký tự 3–4: I1 = VN30, B5 = GB05, BA = GB10, I2 = VN100)
- Năm đáo hạn (ký tự 5: 0 → W, loại trừ I, O, U)
- Tháng đáo hạn (ký tự 6: 1 → C)
- 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/commonsangvnstock/api. - Dùng trực tiếp các lớp
Quote,Finance,Trading,Listing,Companythay cho lớp trung gianVnstock. 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_sheetxử 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 doanhvà_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:
tickerthànhsymbol,HOSEthànhHSX. - Báo lỗi rõ ràng khi gọi
intradayvàprice_depthtrướ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=Falsetắ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_ezcharttrự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
financetừ lớpVnstock()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
plotlythà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_datathêm tham sốinvestor_segment(mặc địnhTrue, gộp lệnh theo nhóm nhà đầu tư); đặtFalseđể nhận bảng chưa gộp.- Thêm hàm
amibroker_ohlc_exportxuấ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_datathêm tham sốdecor: đặtTrueđể đổi tên cột sang dạngOpen, High, Low, Close, Time, Tickervà đặt cộtTimelà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_listingliệt kê các mã chỉ số. - Hàm
financial_ratio_compareso 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_datakhông còn nhân 1000 với chỉ số và mã phái sinh; tham sốbeautify(mặc địnhTrue) 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èmbollinger_bands).
22-08-2023
vnstock
- Hàm
financial_flowthê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_datathêm giá trịderivativecho tham sốtypeđể tra mã phái sinh; khung1Dhiển thị ngày theo định dạngYYYY-mm-dd.
14-07-2023
vnstock
- Phát hành phiên bản 0.17 trên PyPI.
- Hàm mới
price_depthtrả giá và khối lượng theo bước giá cho danh sách mã, dùng song song vớiprice_board.
13-07-2023
vnstock
stock_historical_datatrả giá theo đơn vị VND thay cho nghìn đồng.
05-07-2023
vnstock
financial_ratiotrả bảng chuyển vị, năm hoặc quý làm chỉ mục; tham sốis_allthành tuỳ chọn.industry_analysisvàstock_ls_analysistrả 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_datatra đượ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_datathê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
tradingDatethànhtime.
07-06-2023
vnstock
Hướng dẫn sử dụng bằng tiếng Việt trong tệp README.md.
