Dữ liệu Thị trường
Cập nhật lần cuối:
Thảo luậnMục lục
Unified UI
Kể từ phiên bản 4.0, Vnstock sử dụng kiến trúc Unified UI nhằm mang lại giao diện lập trình nhất quán và dễ sử dụng nhất. Dưới đây là tài liệu chính thức cho phiên bản mới.
Nhóm Market tập trung vào các dữ liệu biến động của thị trường theo thời gian thực và dữ liệu lịch sử cho nhiều loại tài sản khác nhau.
1. Khởi tạo
from vnstock.ui import Market
mkt = Market()2. Các lớp và phương thức chi tiết
A. Lớp equity (Cổ phiếu)
| Phương thức | Tham số | Mô tả |
|---|---|---|
ohlcv() | start, end, interval='1D', count=100 | Lấy dữ liệu nến (Mở, Cao, Thấp, Đóng, Khối lượng). |
trades() | - | Dữ liệu khớp lệnh chi tiết trong ngày (Tick-by-tick). |
quote() | - | Lấy thông tin giá hiện tại (Bảng giá). |
Tham số chính của ohlcv:
start / end: Định dạng 'YYYY-MM-DD'.interval: Khung thời gian. Nhận giá trị 1m, 5m, 15m, 30m, 1h, 1D, 1Wcount: Số lượng nến cần lấy nếu không chỉ địnhstart.
Dữ liệu mẫu (ohlcv):
| time | open | high | low | close | volume |
|---|---|---|---|---|---|
| 2024-01-02 07:00:00 | 55.05 | 55.52 | 54.59 | 55.45 | 1785800 |
| 2024-01-03 07:00:00 | 55.45 | 56.12 | 54.99 | 56.12 | 1373000 |
Ví dụ:
# Lấy dữ liệu nến (OHLCV) của cổ phiếu FPT
df_fpt = mkt.equity("FPT").ohlcv(start="2024-01-01", end="2024-01-31")
# Lấy bảng giá của cổ phiếu VCB
quote_vcb = mkt.equity("VCB").quote()B. Lớp index (Chỉ số)
Truy xuất biến động của các bộ chỉ số thị trường (VNINDEX, VN30...).
| Phương thức | Tham số | Mô tả |
|---|---|---|
ohlcv() | `start, end, interval='1D', length=90 | Biểu đồ giá của chỉ số. |
# Lấy dữ liệu VNINDEX
vnindex = mkt.index("VNINDEX").ohlcv(start="2024-01-01", end="2024-01-31")C. Dữ liệu Tài sản Quốc tế & Khác
Sử dụng nguồn dữ liệu MSN và FMarket để theo dõi các thị trường khác.
| Lớp | Phương thức | Mô tả |
|---|---|---|
forex | ohlcv() | Tỷ giá ngoại hối (ví dụ: "USDVND"). |
crypto | ohlcv() | Giá tiền điện tử (ví dụ: "BTC"). |
commodity | ohlcv() | Giá hàng hóa (ví dụ: "Gold"). |
fund | history() / nav() | Lịch sử giá NAV của quỹ mở. |
etf | ohlcv() / quote() / trades() | Dữ liệu giao dịch chứng chỉ quỹ ETF. |
futures | ohlcv() / quote() / trades() | Dữ liệu hợp đồng tương lai. |
warrant | ohlcv() / quote() / trades() | Dữ liệu chứng quyền có bảo đảm. |
3. Lấy Bảng giá Nhanh
Bạn có thể lấy giá hiện tại cho một hoặc nhiều mã cùng lúc mà không cần thông qua các lớp tài sản.
# Lấy giá của một mã
price_vcb = mkt.quote("VCB")
# Lấy giá của danh mục
prices = mkt.quote(["VCB", "HPG", "FPT"])Lưu ý
Các phương thức trong nhóm Market được thiết kế để tối ưu hóa việc lấy dữ liệu hàng loạt. Nếu bạn cần dữ liệu với tần suất cao và độ chi tiết sâu cho mục đích phân tích tự động, vui lòng tham khảo các tính năng nâng cao tại Bản tài trợ dự án.
Thảo luận