Bản Cộng đồng · vnstock 4.x
Truy vấn tới nguồn bạn chọn, nhận về DataFrame đã chuẩn hoá
Mỗi kết quả kèm tên nguồn để bạn tự đối chiếu.
Thư viện Python chạy trên máy hoặc máy chủ do bạn kiểm soát: gửi truy vấn tới nguồn bạn chọn, trả về bảng pandas đã chuẩn hoá.
from vnstock import Market
mkt = Market()
df = mkt.equity('VIC').ohlcv(length=90)
df.tail(3)| time | open | close | volume | |
|---|---|---|---|---|
| 59 | 2026-09-04 07:00:00 | 244.7 | 256.1 | 7518600 |
| 60 | 2026-09-07 07:00:00 | 256.1 | 245.0 | 6063900 |
| 61 | 2026-09-08 07:00:00 | 243.5 | 249.6 | 6268500 |
Cùng kiểu trả về, dù đổi nguồn
Số liệu chốt phiên 08/09/2026, in ra để minh hoạ định dạng kết quả. Không phải khuyến nghị đầu tư.
- nhóm hàm
- 7nhóm hàm4 nhóm ở bản Cộng đồng, 3 nhóm thêm ở bản Mở rộng
- lượt gọi mỗi phút
- 60lượt gọi mỗi phútbản Cộng đồng; các cấp tài trợ từ 180 đến 600
- cách gọi lệnh
- 3cách gọi lệnhUnified UI, Core Adapter, module theo nguồn
- tham số để đổi nguồn
- 1tham số để đổi nguồnsource; phần còn lại của mã giữ nguyên
Bản Cộng đồng miễn phí cho cá nhân, học tập và nghiên cứu. Mức trần cao hơn thuộc bản Mở rộng, dành cho người tài trợ.
Bảy nhóm hàm
Unified UI chia hàm theo nghiệp vụ tài chính, không theo cấu trúc API của nguồn. Bạn tìm hàm theo cách một người làm tài chính nghĩ.
Bốn nhóm đầu dùng được ngay với bản Cộng đồng. Ba nhóm sau nằm ở bản Mở rộng dành cho người tài trợ — cùng một cách gọi lệnh, thêm nhóm là thêm lớp, không phải học lại.
Reference
Bản Cộng đồngThông tin tham chiếu
Dữ liệu ít thay đổi làm nền cho mọi phân tích khác: hồ sơ doanh nghiệp, danh sách mã, cấu phần chỉ số, lịch sự kiện.
- equity
- index
- company
- etf
- futures
- warrant
- bond
Market
Bản Cộng đồngDữ liệu giao dịch
Giá lịch sử OHLCV từ khung 1 phút đến 1 tuần, khớp lệnh trong ngày và bảng giá hiện tại.
- equity
- index
- etf
- futures
- warrant
- forex
- crypto
- commodity
Fundamental
Bản Cộng đồngPhân tích cơ bản
Báo cáo tài chính theo kỳ và các chỉ số định giá, chuẩn hoá về cùng một khung cột giữa các nguồn.
- income_statement
- balance_sheet
- cash_flow
- ratio
Retail
Bản Cộng đồngThị trường bán lẻ
Dữ liệu thị trường bán lẻ và tỷ giá ngoại tệ ngân hàng, phục vụ việc theo dõi tài sản cá nhân và đối chiếu bối cảnh thị trường.
- exchange_rate
Macro
Bản Mở rộngDữ liệu vĩ mô
Chỉ tiêu kinh tế và giá hàng hoá toàn cầu: GDP, CPI, FDI, xuất nhập khẩu, tỷ giá và lãi suất liên ngân hàng.
- economy
- commodity
- currency
Insights
Bản Mở rộngXếp hạng và bộ lọc
Xếp hạng tăng giảm và giá trị giao dịch theo số liệu nguồn công bố.
- ranking
Analytics
Bản Mở rộngĐịnh giá theo chỉ số
Bội số định giá P/E, P/B theo chuỗi lịch sử của các chỉ số thị trường, dùng để soi mặt bằng giá chung.
- valuation
Đổi nguồn cấp bằng một tham số
Lớp Core Adapter đứng giữa mã của bạn và từng API gốc. Nguồn ngừng hoạt động hay đổi định dạng, bạn sửa một chuỗi ký tự chứ không viết lại quy trình.
from vnstock import Quote
quote = Quote(symbol="VCI", source="VCI")
df = quote.history(start="2024-01-01", end="2024-01-31", interval="1D")
# đổi nguồn: sửa đúng một chuỗi
quote = Quote(symbol="VCI", source="KBS")Bạn chọn nguồn qua tham số source. Danh sách nguồn và phạm vi của từng nguồn nằm ở tài liệu thư viện. Điều kiện sử dụng dữ liệu của mỗi nguồn do bạn tự kiểm tra.
Unified UI
mặc địnhfrom vnstock import MarketCore Adapter
quen bản cũfrom vnstock import Quote, FinanceModule nguồn cấp
người dùng nâng caofrom vnstock.explorer.vci.listing import Listing
Bản Cộng đồng dừng ở đâu
Hạn mức và độ sâu dữ liệu của bản Cộng đồng, ghi rõ để bạn biết trước khi dựng quy trình.
- Giấy phép
- Công khai mã nguồn theo giấy phép riêng
- Mức phí
- Miễn phí cho cá nhân, học tập và nghiên cứu
- Phân phối
- PyPI và GitHub
- Hạn mức
- Tối đa 60 yêu cầu mỗi phút khi dùng khoá API tạo trên website
- Truy vấn
- Qua REST, cập nhật theo độ trễ của nguồn
- Lịch sử giá
- Tối đa 8 năm khung ngày, 1 năm khung phút
- Giao dịch trong ngày
- Tối đa 30.000 bản ghi
- Báo cáo tài chính
- Tối đa 8 kỳ khi xác thực khoá API, 4 kỳ ở chế độ khách
- Tải song song
- Bạn tự cấu hình
Bảng đối chiếu từng hàm giữa bản Cộng đồng và bản Mở rộng nằm trong tài liệu so sánh.
Vnstock không làm những việc này
- Không vận hành kho dữ liệu thị trường để bán lại hay phân phối nội dung nguồn.
- Không cấp quyền sử dụng dữ liệu của nguồn: quyền dùng phần mềm và quyền dùng dữ liệu là hai thứ khác nhau.
- Không đưa ra tư vấn, khuyến nghị mua bán hay dự báo giá.
Vnstock cấp quyền sử dụng phần mềm cho cá nhân. Bản Cộng đồng chỉ dành cho mục đích cá nhân, học tập và nghiên cứu. Ở các cấp tài trợ, phạm vi tính theo số người dùng, số thiết bị đã đăng ký và hạn mức của cấp; trong phạm vi đó bạn được dùng cho công việc của chính mình, kể cả công việc có thu nhập. Hai việc cần thoả thuận riêng bằng văn bản: phân phối lại phần mềm, và làm sản phẩm mà giá trị chính là cấp cho bên thứ ba khả năng truy xuất dữ liệu; gửi đề nghị qua trang hợp tác.
Phần mềm chạy trên hạ tầng của bạn và gửi truy vấn thẳng tới nguồn bạn chọn, nên điều kiện của từng nguồn áp dụng trực tiếp với bạn. Danh sách nguồn và phạm vi từng nguồn nằm ở trang nguồn dữ liệu.
Để trợ lý AI viết mã vnstock đúng cú pháp bản mới nhất
Trợ lý AI học trên cú pháp của các phiên bản đã bỏ nên hay viết sai. Dán một lời nhắc bạn đọc được trước, trợ lý dùng bản chỉ dẫn công khai trên web, luôn mới nhất.
Khi bản Cộng đồng không đủ
Bốn thư viện bản Mở rộng dùng cùng kiến trúc, cùng cách gọi lệnh. Chuyển sang bản Mở rộng là đổi câu lệnh import, không viết lại quy trình.
- Nhóm hàm
- 4 nhóm7 nhóm
- Hạn mức gọi
- 60 lượt/phút180–600 tuỳ cấp
Hàm mở rộng
Thêm nhóm hàm vĩ mô, định giá và thống kê vào giao diện của vnstock, cùng cách gọi lệnh.
vnstock_ta
Tính chỉ báo phân tích kỹ thuật ngay trên bảng dữ liệu bạn vừa truy xuất.
vnstock_news
Theo dõi tin tức tài chính từ các trang tin bạn chọn, đọc bài tại trang gốc.
vnstock_pipeline
Dựng quy trình cập nhật dữ liệu theo lịch trên danh sách mã bạn chọn.
Quyền lợi và điều kiện từng cấp nằm ở trang các cấp tài trợ.
Cài đặt và lấy bảng dữ liệu đầu tiên trong năm phút
Tài liệu hướng dẫn đi từ dựng môi trường Python đến truy vấn đầu tiên. Muốn thử ngay mà không cài gì, có bản chạy trên trình duyệt.