Lớp Retail: hàm truy xuất dữ liệu thị trường bán lẻ
Mục lục
Bản mặc định hiện là vnstock v5.0.0, gộp bản Cộng đồng và bản Mở rộng vào một thư viện. Trang này giữ lại cho máy còn cài vnstock v4.x: mã viết theo trang này vẫn chạy với bản đó. Đã cài bản mới thì đọc trang tương ứng của v5.0.0.
Máy đang cài bản nào: chạy python -c "import vnstock; print(vnstock.__version__)", ra số bắt đầu bằng 5. là thế hệ 5.
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.
Bản Cộng đồng có các hàm truy xuất dữ liệu thị trường cơ bản. Nếu bạn cần các hàm dữ liệu giao dịch chi tiết hơn như sổ lệnh, dòng tiền khối ngoại hay khớp lệnh từng giao dịch, xem tài liệu Dữ Liệu Giao Dịch (Market Data) của thư viện vnstock_data thuộc bản Mở rộng dành cho người tài trợ.
Lớp Retail được quy hoạch để truy xuất các nhóm thông tin thị trường bán lẻ (hiện hỗ trợ tỷ giá hối đoái ngân hàng...), phục vụ nhu cầu theo dõi tài sản cá nhân và đối chiếu bối cảnh thị trường.
1. Khởi tạo
from vnstock import Retail
# Khởi tạo đối tượng Retail (có trong Bản Cộng đồng)
ret = Retail()2. Các phương thức chi tiết
Phương thức exchange_rate() (Tỷ giá Ngoại tệ)
Theo dõi biến động tỷ giá ngoại hối trực tiếp từ ngân hàng Vietcombank (VCB).
- Cú pháp:
exchange_rate(date='') - Tham số:
date: Định dạng 'YYYY-MM-DD'. Để trống để lấy tỷ giá hiện tại.
- Dữ liệu trả về (Schema):
currency: Mã tiền tệ (USD, EUR, JPY...).buy_cash: Giá mua tiền mặt.buy_transfer: Giá mua chuyển khoản.sell: Giá bán ra.
# Xem tỷ giá ngoại tệ hiện tại từ ngân hàng Vietcombank
df_fx = ret.exchange_rate()
print(df_fx.head())3. Lưu ý về dữ liệu
- Dữ liệu tỷ giá được truy xuất từ kênh công bố tỷ giá của Vietcombank (VCB).
- Tần suất cập nhật phụ thuộc vào nguồn (thường cập nhật trong giờ hành chính, theo độ trễ của nguồn).
- Dữ liệu được trả về dưới dạng
pandas.DataFramechuẩn, giúp bạn dễ dàng tích hợp vào các bảng tính hoặc biểu đồ theo dõi cá nhân.