Mức hoàn thiện
Thử nghiệmBản thử nghiệmCập nhật
Mục lục
Bản thử nghiệm, chưa phát hành chính thức
Trang này viết cho vnstock_mcp v1.0.0rc1, bản thử nghiệm. Tên hàm, tham số và cột dữ liệu có thể còn đổi trước ngày phát hành; khi cài, ghi rõ số phiên bản như ở trang Cài đặt. Bản đang phát hành chính thức là v0.4.0, xem tài liệu bản đó.
Trang này ghi trạng thái của bản 1.0.0rc1 tại ngày 06/11/2026, với vnstock 6.0.0rc3, vnstock-oapi 0.1.0rc2,
vnstock_quant 1.0.0rc1. Đây là quan sát tại thời điểm kiểm, không phải cam kết về dữ liệu hay thời gian phản hồi
của nguồn.
Cách đọc cột "Trạng thái":
- Có, chạy thật: có trong mã, có kiểm thử tự động, và đã chạy qua máy chủ MCP với dữ liệu thật của nguồn.
- Có, kiểm tự động: có trong mã và kiểm thử tự động trên dữ liệu mẫu; chưa chạy với dữ liệu thật trong đợt này.
- Chưa có: chưa có trong bản này.
Tổng quan
| Phần | Trạng thái | Ghi chú |
|---|---|---|
Giá cổ phiếu ohlcv | Có, chạy thật | ssi, dnse, fhsc |
Khớp lệnh trades, lịch sử phiên trade_history | Có, chạy thật | trades qua dnse, trade_history qua ssi |
Báo cáo tài chính fundamental_equity | Có, chạy thật | fhsc |
| Các tool tra cứu và thị trường khác | Có, kiểm tự động | Route của từng giá trị method được kiểm với thư viện đang cài; chưa gọi thật từng giá trị |
Nguồn tcbs, fmp | Có, kiểm tự động | Chưa chạy với khoá thật trong đợt này |
| Chỉ báo, rủi ro, bảng lợi suất, hiệp phương sai | Có, chạy thật | |
Tối ưu danh mục max_sharpe | Có, chạy thật | Với FPT, VCB, HPG một năm đến 06/11/2026, cả ba mã có lợi suất trung bình âm nên thư viện báo Sharpe tối đa không xác định; đã kiểm trên dữ liệu mẫu |
Chỉ số tài chính quant_fa | Có, chạy thật | BCTC fhsc, giá ssi. Chỉ số định giá trả MISSING_MARKET khi chưa bật estimate_shares; tổ hợp estimate_shares với price_source chưa chạy thật |
Giá điều chỉnh quant_prices | Có, chạy thật | ssi cho cả phiên và sự kiện. Một năm dữ liệu mất hơn 60 giây; gọi lại khi gặp StillRunning |
Vi cấu trúc quant_micro | Có, chạy thật | Nến khối lượng, CVD, VPIN trên khớp lệnh dnse |
Backtest run_backtest với bảng quy tắc, eval_rule_dsl, monte_carlo | Có, chạy thật | |
run_portfolio, sweep, walk_forward, deflated_sharpe_ratio | Có, kiểm tự động | Chạy qua máy chủ trên dữ liệu mẫu với tài khoản cấp Diamond |
Nhập bảng research_import | Có, chạy thật | Tệp CSV kiểu Việt Nam qua chỉ báo, rủi ro, backtest |
| Nhật ký, script tái lập | Có, chạy thật | Script của phiên thật chạy lại thành công |
BCTC PDF: research_pdf, research_bctc, research_vas | Có, kiểm tự động | Chưa chạy trên báo cáo thật trong đợt này |
Cảnh báo của thư viện trong warnings | Có, chạy thật | |
| Khoá nguồn không lọt ra đầu ra | Có, kiểm tự động | Khoá giả có dấu nhận diện không xuất hiện ở dòng lệnh, instructions, kết quả, lỗi, log, tệp ghi ra |
Cấu hình --setup cho 8 ứng dụng | Có, kiểm tự động | Chưa thử trong từng ứng dụng với bản này |
| HTTP trên loopback | Có, kiểm tự động | |
| Bản dựng sẵn | Có cho macOS chip Apple | Bản cho Windows và Linux chưa dựng |
Tầng macro, insights, analytics, retail | Chưa có | Chưa có nguồn Open API nào đọc được; tool không hiện ra |
| Tin tức | Chưa có | Không có ở thế hệ 6; trợ lý tự tìm tin bằng công cụ của nó |
Hạn chế đã biết
- Khoá trong tệp
.envthường không được thấy. Ứng dụng AI khởi chạy máy chủ từ thư mục của chính ứng dụng, màvnstock-oapichỉ đọc.envở thư mục đang chạy. Cất khoá bằngvnstock keys set <nguồn>(Cài đặt và kết nối). - Hạn dùng 30 ngày. Bản thử nghiệm hết hạn sau 30 ngày kể từ ngày dựng; cần cập nhật bản kế tiếp.
- Lời gọi tải nhiều dữ liệu có thể quá 60 giây. Gọi lại đúng tham số khi gặp
StillRunning; máy chủ không gửi thêm yêu cầu tới nguồn cho lần gọi lại. - Giới hạn tần suất của nguồn. Nhiều lời gọi tải báo cáo tài chính liên tiếp có thể bị nguồn từ chối tạm thời (mã 429). Đợi vài phút rồi gọi lại.
- Số cổ phiếu theo ngày chưa có qua Open API, nên chỉ số định giá cần
estimate_shares=truevà là số ước tính.