Bản Cộng đồng · vnstock 4.x
Dữ liệu thị trường tài chính, trả về dưới dạng DataFrame
Mọi con số trên trang này đều truy được về nguồn.
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ề, từ mọi nguồn
- VCI
- KBS
- MSN
- FMarket
- SJC · BTMC · VCB
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 dữ liệu
- 7nhóm dữ liệu4 nhóm dùng ngay, 3 nhóm khi tài trợ
- yêu cầu mỗi phút
- 60yêu cầu mỗi phútbản Cộng đồng; tài trợ tăng tới 10 lần
- bản ghi khớp lệnh mỗi ngày
- 30.000bản ghi khớp lệnh mỗi ngàybản Cộng đồng; tài trợ không giới hạn
- năm lịch sử khung ngày
- 8năm lịch sử khung ngàybản Cộng đồng; tài trợ lấy toàn bộ từ khi niêm yết
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 dữ liệu
Unified UI chia dữ liệu 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
Dùng ngayThô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
- fund
Market
Dùng ngayDữ 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
- fund
- forex
- crypto
- commodity
Fundamental
Dùng ngayPhâ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
Dùng ngayVàng và tỷ giá
Giá vàng trong nước từ các nguồn niêm yết 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.
- gold
- exchange_rate
Macro
Khi tài trợDữ 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, lao động, tỷ giá và lãi suất liên ngân hàng.
- economy
- commodity
- currency
Insights
Khi tài trợXếp hạng và bộ lọc
Xếp hạng tăng giảm, giá trị giao dịch và giao dịch khối ngoại; bộ lọc cổ phiếu chạy trên toàn thị trường.
- ranking
- screener
Analytics
Khi tài trợĐị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")- VCI
- giá lịch sử, báo cáo tài chính
- KBS
- giá lịch sử, chạy được trên Colab
- MSN
- ngoại tệ, hàng hoá, tiền mã hoá
- FMarket
- quỹ mở
- SJC · BTMC · VCB
- giá vàng và tỷ giá ngân hàng
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
- Dữ liệu trong phiên
- Qua REST API, độ trễ khoảng 1–5 giây tuỳ 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á.
Bản Cộng đồng dành cho 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ị và hạn mức chứ không theo mục đích, nên việc có doanh thu nằm trong phạm vi được cấp. Hai việc cần thoả thuận riêng là phân phối lại phần mềm và làm sản phẩm thay thế việc 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 câu kích hoạt, trợ lý nạp bản chỉ dẫn từ web và làm theo tài liệu luôn mới nhất.
Khi bản Cộng đồng không đủ
Bốn thư viện mở rộng dùng cùng kiến trúc, cùng cách gọi lệnh. Nâng cấp là đổi câu lệnh import, không viết lại quy trình.
- Nhóm dữ liệu
- 4 nhóm7 nhóm
- Hạn mức gọi
- 60 yêu cầu/phút180–600 tuỳ cấp
- Lịch sử giá
- 8 năm khung ngàyToàn bộ từ khi niêm yết
- Báo cáo tài chính
- 8 kỳKhông giới hạn số kỳ
vnstock_data
Truy xuất dữ liệu từ nguồn truy cập công khai, hạn mức và độ sâu lịch sử mở rộng.
vnstock_ta
Tính chỉ báo phân tích kỹ thuật ngay trên bảng dữ liệu vừa lấy về.
vnstock_news
Trích xuất và chuẩn hoá tin tức thị trường từ các trang báo tài chính.
vnstock_pipeline
Dựng quy trình cập nhật dữ liệu tự động và xử lý đa luồng cho khối lượng lớ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.