Hệ sinh thái thư viện nghiên cứu tài chính thế hệ 5
Một cấu trúc dữ liệu nhất quán. Bốn thư viện cho từng bước của quy trình phân tích.
Hợp nhất vnstock 4.x và vnstock_data 3.x trên lõi Rust hiệu năng cao. Cùng một cách gọi, cùng tên lớp, quản lý quyền hạn động qua khoá API. Đi cùng là bộ công cụ chuyên biệt cho định lượng, dòng tin và tự động hoá dữ liệu trên chính máy tính của bạn.
python3 -m venv ~/.venv
source ~/.venv/bin/activate
pip install -U --extra-index-url https://vnstocks.com/api/packages vnstockYêu cầu Python 3.10 trở lên, chạy trên Windows, macOS và Linux. Lệnh trên dành cho macOS và Linux; trên Windows môi trường là $HOME\.venv, còn Google Colab cài thẳng không cần môi trường ảo — xem trang Cài đặt trong tài liệu.
vnstock 4.x
Bản Cộng đồng cũ
vnstock_data 3.x
Bản Mở rộng cũ
thư viện vnstock 5
Một thư viện dùng chung cho mọi cấp
from vnstock_data import Marketfrom vnstock import Market Market().equity("FPT").ohlcv(length=20)Tên lớp, tham số và phương thức của giao diện hợp nhất được bảo toàn nguyên vẹn.
Thế hệ 5 đã phát hành chính thức. Mỗi bản có hạn dùng 365 ngày kể từ ngày phát hành trên kho gói; khi còn dưới 30 ngày, thư viện tự nhắc bạn nâng cấp.
Bốn thay đổi quan trọng ở thế hệ 5
Không chỉ hợp nhất hai thư viện, Thế hệ 5 làm lại từ lõi xử lý, hệ thống ngoại lệ đến cơ chế cấp quyền động, giúp mã nghiên cứu của bạn bền vững và nhất quán.
Một thư viện lõi cho mọi cấp
Xoá bỏ phân mảnh gói
Bản Cộng đồng và bản Mở rộng nay là hai cấp quyền trên cùng thư viện vnstock, không còn là hai gói cài đặt tách biệt. Cùng một lệnh cài, cùng tên lớp, cùng chữ ký hàm.
vnstock registerKhông yêu cầu cài đặt lại khi thay đổi cấp tài khoản. Mọi cấp dùng chung một bản cài đặt duy nhất.
Lõi xử lý Rust hiệu năng cao
Tốc độ, an toàn bộ nhớ và tính chuẩn mực
Toàn bộ logic truy xuất, làm sạch và chuẩn hoá được viết lại trên lõi Rust. Dữ liệu trả về đối tượng pandas.DataFrame nhất quán, kèm metadata nguồn gốc minh bạch trong df.attrs.
df.attrs["source"]Không trung chuyển truy vấn qua máy chủ Vnstock. Truy vấn xuất phát từ máy bạn đi thẳng tới nguồn.
Hệ thống ngoại lệ có kiểu
Không còn lỗi in ngầm rồi trả None
Mọi lỗi trả về ngoại lệ có kiểu rõ ràng (InputError, AuthError, RateLimitedError). Mỗi lỗi mang mã ổn định e.code và gợi ý hành động e.action, giúp mã của bạn và trợ lý AI dễ dàng xử lý.
except InputError as e:Không đoán khi cấu trúc nguồn thay đổi. Thư viện báo lỗi chuẩn mực thay vì âm thầm trả kết quả sai lệch.
Gói quyền lợi và cấp quyền minh bạch
Đồng bộ linh hoạt qua máy chủ
Vnstock là hệ sinh thái phần mềm và dịch vụ hỗ trợ. Quyền lợi được phân định theo gói rõ ràng và dễ hiểu: mở quyền sử dụng các bộ thư viện chuyên biệt (định lượng, tin tức, pipeline tự động hoá), số thiết bị đăng ký và mức ưu tiên hỗ trợ kỹ thuật. Thư viện tự động đồng bộ quyền hạn mà bạn không cần thay đổi hay viết lại mã.
vnstock.status()Vnstock cấp quyền sử dụng phần mềm và dịch vụ hỗ trợ, không bán dữ liệu. Mọi phân tích và tính toán diễn ra trực tiếp trên máy của bạn.
Bộ 4 thư viện: Từ tổng hợp dữ liệu đến quy trình hoàn chỉnh
Thế hệ 5 được tổ chức thành 4 khối chuyên biệt theo chuỗi giá trị nghiên cứu đầu tư: bắt đầu từ bước tổng hợp dữ liệu, xây dựng cơ sở dữ liệu cục bộ, tính toán định lượng quy mô lớn với hiệu năng cao, cho tới đối chiếu bối cảnh tin tức. Các thư viện kết nối liền mạch với nhau thông qua cấu trúc bảng pandas.DataFrame chuẩn mực.
vnstock
Truy xuất và chuẩn hoá dữ liệu
Công cụ hỗ trợ bước đầu tiên của phân tích: tổng hợp dữ liệu chứng khoán, hồ sơ doanh nghiệp, báo cáo tài chính, vĩ mô và tỷ giá. Vnstock không phải nhà cung cấp dữ liệu; thư viện chạy trên máy của bạn, chỉ tải những gì bạn có quyền đọc và tuân theo chính sách sử dụng của nguồn, trả về pandas.DataFrame chuẩn mực.
vnstock_pipeline
Lưu trữ và tự động hoá trên máy của bạn
Tự động hoá việc tải dữ liệu theo lô và dựng cơ sở dữ liệu nghiên cứu trên máy của bạn, cho nhóm cổ phiếu bạn chọn. Kiểm tra tính toàn vẹn dữ liệu, cách ly bản ghi lỗi, rồi đưa vào Vnstock Quant hoặc xuất sang AmiBroker, Parquet, Excel.
vnstock_quant
Phân tích định lượng
Tính toán định lượng quy mô lớn với hiệu năng cao nhờ lõi Rust. Kết hợp với Vnstock Pipeline khi đã có cơ sở dữ liệu thị trường/nhóm cổ phiếu, giúp bạn giao tiếp và phân tích dễ dàng thông qua trợ lý AI hoặc lập trình Python dễ hiểu: hơn 58 chỉ báo kỹ thuật, chỉ số tài chính, rủi ro và tối ưu danh mục.
vnstock_news
Theo dõi tin tức
Đọc và tổng hợp luồng tin tức theo các tiêu chuẩn mở (RSS, XML Sitemap). Thư viện cấu hình sẵn các trang báo chính thống có chính sách truy cập thân thiện (tuân thủ chuẩn mực robots.txt), đồng thời cho phép bạn tự thêm cấu hình cho bất kỳ website nào hỗ trợ nguồn cấp tin để theo dõi tiêu đề, thời gian xuất bản và liên kết gốc.
vnstock
Thay thế vnstock 4.x và vnstock_data 3.x
Công cụ hỗ trợ bước đầu tiên của phân tích: tổng hợp dữ liệu chứng khoán, hồ sơ doanh nghiệp, báo cáo tài chính, vĩ mô và tỷ giá. Vnstock không phải nhà cung cấp dữ liệu; thư viện chạy trên máy của bạn, chỉ tải những gì bạn có quyền đọc và tuân theo chính sách sử dụng của nguồn, trả về pandas.DataFrame chuẩn mực.
Không phải nhà cung cấp dữ liệu, không đặt lệnh, không vận hành kho dữ liệu tập trung để bán lại.
vnstock_pipeline
Phiên bản 3.x viết lại
Tự động hoá việc tải dữ liệu theo lô và dựng cơ sở dữ liệu nghiên cứu trên máy của bạn, cho nhóm cổ phiếu bạn chọn. Kiểm tra tính toàn vẹn dữ liệu, cách ly bản ghi lỗi, rồi đưa vào Vnstock Quant hoặc xuất sang AmiBroker, Parquet, Excel.
Không chuyển dữ liệu cho bên thứ ba, không dùng chung thông tin đăng nhập.
vnstock_quant
Thay thế vnstock_ta
Tính toán định lượng quy mô lớn với hiệu năng cao nhờ lõi Rust. Kết hợp với Vnstock Pipeline khi đã có cơ sở dữ liệu thị trường/nhóm cổ phiếu, giúp bạn giao tiếp và phân tích dễ dàng thông qua trợ lý AI hoặc lập trình Python dễ hiểu: hơn 58 chỉ báo kỹ thuật, chỉ số tài chính, rủi ro và tối ưu danh mục.
Không đưa tín hiệu mua bán hay khuyến nghị đầu tư. Không hoạt động như một hộp đen.
vnstock_news
Phiên bản 3.x viết lại
Đọc và tổng hợp luồng tin tức theo các tiêu chuẩn mở (RSS, XML Sitemap). Thư viện cấu hình sẵn các trang báo chính thống có chính sách truy cập thân thiện (tuân thủ chuẩn mực robots.txt), đồng thời cho phép bạn tự thêm cấu hình cho bất kỳ website nào hỗ trợ nguồn cấp tin để theo dõi tiêu đề, thời gian xuất bản và liên kết gốc.
Nội dung bài viết thuộc về toà soạn. Thư viện tôn trọng robots.txt và nhịp truy vấn của trang tin; không đăng lại hay phân phối bài viết.
Phân quyền thư viện theo cấp tài khoản
Quyền được cấp động qua máy chủ xác thực. Khi cấp tài trợ của bạn thay đổi, các thư viện đã cài đặt tự kích hoạt quyền tương ứng mà không cần cài đặt lại.
| Thư viện và phân hệ chức năng | Cộng đồng | Bronze | Silver | Golden, Diamond |
|---|---|---|---|---|
| vnstockTruy xuất dữ liệu thị trường (giá, hồ sơ, BCTC, vĩ mô, tỷ giá) | Hỗ trợ | Hỗ trợ | Hỗ trợ | Hỗ trợ |
| vnstock_quantTính toán định lượng: 58+ chỉ báo kỹ thuật, 99+ chỉ số BCTC, đo lường rủi ro & danh mục | Dùng thử: 30 phép tính/ngày | Chỉ số BCTC & rủi ro | Hỗ trợ | Hỗ trợ |
| vnstock_newsĐọc nguồn cấp tin chuẩn mở (RSS, Sitemap) có sẵn và tự cấu hình | Không hỗ trợ | Không hỗ trợ | Hỗ trợ | Hỗ trợ |
| vnstock_pipelineTự động hoá tải dữ liệu theo lô, quản lý cơ sở dữ liệu trên máy & xuất AmiBroker | Không hỗ trợ | Không hỗ trợ | Không hỗ trợ | Hỗ trợ |
* vnstock_quant: Cấp Cộng đồng dùng thử 30 phép tính/ngày; cấp Bronze mở chỉ số tài chính BCTC và đo lường rủi ro; cấp Silver trở lên mở trọn bộ 58+ chỉ báo kỹ thuật nâng cao và thư viện tính toán định lượng.
Không cần khoá API, thư viện vnstock vẫn cho phép bạn sử dụng ngay ở cấp Khách với các tính năng cơ bản. Khi cấu hình khoá tài khoản, bạn có thể kiểm tra danh sách các thư viện mở rộng trong gói quyền lợi bằng lệnh: vnstock install --list.
Tài trợ là cách bạn đồng hành duy trì cơ sở hạ tầng, tài liệu và mã nguồn Vnstock. Người tài trợ nhận được quyền sử dụng phần mềm mở rộng có thời hạn, gói quyền lợi công cụ chuyên sâu hơn và quyền ưu tiên hỗ trợ kỹ thuật.
Xem các gói tài trợVnstock không bán dữ liệu; dữ liệu vẫn đến từ nguồn bên thứ ba như ở bản Cộng đồng. Các cấp tài trợ cấp quyền cho cá nhân theo số người dùng, số thiết bị và hạn mức.
Đọc giấy phép sử dụng phần mềmTừ câu hỏi nghiên cứu đến hệ thống có thể tự kiểm chứng
Vnstock là hệ sinh thái tự động hoá cá nhân trong nghiên cứu đầu tư, vận hành trực tiếp trên máy tính của bạn. Bộ công cụ được thiết kế để bạn làm chủ mã lệnh, tự kết nối số liệu và tự kiểm chứng quy trình phân tích của mình.
Làm chủ mã lệnh thay vì công cụ đóng sẵn
Trí tuệ nhân tạo không làm mất đi giá trị của tư duy lập trình, mà giúp bất kỳ ai cũng có thể tận dụng sức mạnh của mã lệnh mà không cần trở thành lập trình viên chuyên nghiệp. Bạn đưa ra bài toán và phương pháp; trợ lý AI hỗ trợ tạo dòng lệnh; các thư viện Vnstock đóng vai trò công cụ thực thi và tính toán chuẩn xác trên máy tính của bạn.
Quy trình tự kiểm chứng, minh bạch phương pháp
Mỗi bảng kết quả ghi nguồn gốc trong df.attrs, mỗi công thức có tài liệu đi kèm. Bạn tự kiểm tra, tự tính toán và giải trình được từng bước, từ bảng số liệu thô tới kết quả cuối cùng.
Vận hành trên máy trạm, tôn trọng quyền riêng tư
Ý tưởng nghiên cứu, tham số thuật toán và danh mục phân tích là tài sản riêng của mỗi cá nhân. Toàn bộ mã lệnh, quy trình tính toán và dữ liệu do bạn truy xuất đều nằm trực tiếp trên máy tính cá nhân. Vnstock không lưu trữ chiến lược hay nội dung nghiên cứu của người dùng trên máy chủ.
Cú pháp lập trình đồng nhất và ổn định
Các nguồn bên thứ ba có định dạng khác nhau và thay đổi theo thời gian. Bộ thư viện Vnstock đưa việc truy xuất và tính toán về những hàm Python đồng nhất, để mã của bạn ít phải sửa khi nguồn đổi và trợ lý AI viết mã đúng hơn.
Mọi công cụ đều tuân thủ nguyên tắc: Tự kiểm chứng. Tự chịu trách nhiệm. Không hộp đen.
Chạy trên máy cá nhân · Tôn trọng quyền riêng tưVới mã bạn đang chạy
Thế hệ 5 được thiết kế để giữ tính liên tục cao nhất. Bảng dưới đây tóm tắt những điểm bạn sẽ thấy khác ngay trong lần chạy đầu tiên.
- Mô hình thư viện
- Hai gói tách biệt: vnstock 4.x (Cộng đồng) và vnstock_data 3.x (Mở rộng)
- Một thư viện vnstock duy nhất. Khoá API quyết định quyền truy xuất, không quyết định cách viết mã
- Cài đặt & Quản lý
- Hai đường cài khác nhau; người tài trợ cần trình cài đặt riêng vnstock-installer
- Cài một lệnh pip từ kho gói chính thức; quản lý gói bổ sung bằng lệnh vnstock install
- Cú pháp import
- from vnstock_data import Market, Reference
- from vnstock import Market, Reference (giữ nguyên tên lớp và tên hàm của giao diện hợp nhất)
- Mã kế thừa kiểu cũ
- Quote, Listing, Company, Finance, Trading viết theo từng adapter nguồn
- Vẫn import được và chạy qua lõi mới. Đã gỡ lớp Vnstock() kiểu cũ và lớp Broker
- Cơ chế báo lỗi
- Nhiều hàm in thông báo lỗi ra màn hình (print) rồi âm thầm trả về None
- Ném ngoại lệ có kiểu (InputError, AuthError), mang mã e.code và hướng xử lý ở e.action
- Tham số ohlcv(length=N)
- N ngày ở vnstock_data 3.x
- N nến của khung thời gian đang yêu cầu. Muốn lấy theo ngày, viết length="30d" hoặc truyền start, end
Mã viết theo giao diện hợp nhất (Market, Reference) tiếp tục chạy sau khi điều chỉnh nhỏ; mã viết theo cú pháp Vnstock().stock(...) cần viết lại theo chuẩn mới.
Hướng dẫn chuyển từ vnstock 4.xGần như toàn bộ tên lớp và hàm được giữ nguyên, công việc chính là đổi dòng import sang vnstock. Tài liệu liệt kê những điểm mặc định thay đổi có chủ ý.
Hướng dẫn chuyển từ vnstock_data 3.xCác lớp kiểu cũ và mô-đun theo từng nguồn vẫn được giữ lại để tương thích ngược, tự động định tuyến qua lõi xử lý Rust mới.
Lớp kiểu cũ và tương thích ngượcBạn có thể kiểm tra phiên bản thư viện hiện tại trong môi trường bằng lệnh: python -c "import vnstock; print(vnstock.__version__)". Nếu phiên bản bắt đầu bằng số 5, bạn đang chạy trên Thế hệ 5.
Những gì Vnstock không làm
Thế hệ 5 mang lại nhiều thay đổi về kỹ thuật và kiến trúc, nhưng các nguyên tắc pháp lý và ranh giới hoạt động dưới đây giữ nguyên.
Không đặt lệnh & môi giới
Không có chức năng giao dịch hay môi giới. Thế hệ 5 chỉ phục vụ mục đích nghiên cứu và xử lý dữ liệu.
Không đưa khuyến nghị đầu tư
Không phát tín hiệu mua bán, không đề xuất danh mục cổ phiếu. Kết quả phân tích là số liệu do bạn tự truy xuất, tự tính toán và tự diễn giải.
Không kinh doanh dữ liệu
Vnstock không vận hành kho dữ liệu thị trường để bán lại. Dữ liệu đến từ nguồn bên thứ ba; điều khoản sử dụng của từng nguồn do bạn tự chịu trách nhiệm kiểm tra.
Không trung chuyển dữ liệu
Máy chủ vnstocks.com chỉ dùng để xác thực khoá API, cấp tài khoản và kiểm soát hạn mức. Toàn bộ dữ liệu bạn truy xuất đi thẳng từ máy bạn tới nguồn.
Không phải mã nguồn mở
Thư viện thế hệ 5 phát hành dạng đóng gói sẵn theo giấy phép riêng. Bản Cộng đồng miễn phí cho cá nhân, học tập và nghiên cứu. Các cấp tài trợ cấp quyền cho cá nhân theo số người dùng, số thiết bị và hạn mức.
Không bảo đảm thay nguồn
Vnstock là công cụ phần mềm chạy trên máy của bạn, không phải nguồn phát hành dữ liệu. Tính sẵn sàng và độ chính xác phụ thuộc vào nguồn; hãy đối chiếu trước khi đưa ra quyết định.
Vnstock là phần mềm phân tích chạy trên máy của bạn. Khi bạn đăng nhập hoặc khi thư viện kiểm tra giấy phép, các dịch vụ quản lý tài khoản, thiết bị và hạn mức được xử lý bảo mật theo Chính sách quyền riêng tư.
Cài đặt và khởi tạo phiên nghiên cứu đầu tiên
Lấy khoá API tại trang tài khoản. Lưu khoá vào biến môi trường VNSTOCK_API_KEY hoặc cấu hình qua dòng lệnh bằng vnstock register. Tuyệt đối không lưu khoá trực tiếp trong mã nguồn.
1. Cài đặt thư viện vào môi trường ảo ~/.venv
Cài đặt qua pippython3 -m venv ~/.venv source ~/.venv/bin/activate pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock2. Cấu hình khoá API và cài đặt hệ sinh thái
Dòng lệnh quản trị vnstockvnstock register vnstock install3. Truy xuất dữ liệu và tính toán
from vnstock import Market, Reference # Lấy 50 nến giá gần nhất của FPT df_price = Market().equity("FPT").ohlcv(length=50) # Lấy hồ sơ và tỷ lệ tài chính cơ bản overview = Reference().company("FPT").overview()