Nguồn dữ liệu
Mục lục
Trang này viết cho vnstock v6.0.0rc2, bản thử nghiệm. Tên hàm, tham số và cột dữ liệu có thể còn đổi trước ngày phát hành; khi cài, ghi rõ số phiên bản như ở trang Cài đặt. Bản đang phát hành chính thức là v5.0.1, xem tài liệu bản đó.
Chọn nguồn bạn có khoá, mã trên trang sẽ điền theo. Chưa chọn thì mã giữ chỗ trống <nguồn>. Nguồn xếp theo bảng chữ cái, không phải khuyến nghị.
Mỗi nguồn có tài khoản, phạm vi truy cập và điều khoản riêng. Bảng dưới tóm tắt nhóm dữ liệu mà bản
6.0.0rc2 hỗ trợ ở từng nguồn. Danh sách theo từng hàm ở Thị trường
và Tham chiếu.
source= | Nhóm dữ liệu | Cần |
|---|---|---|
ssi | Nến cổ phiếu, chỉ số, hợp đồng tương lai; thống kê phiên; khối ngoại, tự doanh theo chỉ số; danh sách mã, rổ chỉ số, ngành, chứng quyền; lịch sự kiện; giá trần sàn | API Key, Secret |
dnse | Nến; khớp lệnh cổ phiếu, phái sinh, chứng quyền; sổ lệnh; bảng giá phái sinh; chỉ số trong phiên; khối ngoại, room ngoại; giá dự kiến; danh sách mã, trạng thái mã; phiên và ngày giao dịch; giá trần sàn | API Key, Secret |
tcbs | Nến; bảng giá cổ phiếu, phái sinh, chứng quyền; khớp lệnh; sổ lệnh; thoả thuận; khớp theo bước giá; thông tin hợp đồng tương lai | API Key, Smart OTP mỗi phiên 24 giờ |
fhsc | Nến cổ phiếu, chỉ số, tiền mã hoá, ngoại hối, hàng hoá; bảng giá; khối ngoại, tự doanh, room ngoại; mua bán chủ động; thông tin doanh nghiệp, cổ đông, giao dịch nội bộ, lịch sự kiện; quỹ mở; báo cáo tài chính (bảng cân đối, kết quả kinh doanh, lưu chuyển tiền tệ) | API Key |
fmp | Nến tiền mã hoá, ngoại hối, hàng hoá; tìm mã; lịch nghỉ của các sàn | API Key |
binance | Tiền mã hoá: nến, bảng giá, sổ lệnh, khớp lệnh, thống kê 24 giờ | Không cần khoá |
Liệt kê hàm của một nguồn ngay trên máy: vnstock tools --source <nguồn>.
Điều cần biết
tcbs: mở phiên bằngvnstock-oapi auth tcbsvà Smart OTP từ ứng dụng của nguồn. Phiên dùng 24 giờ, chung cho cả máy. Hết phiên thì hàm báoOtpRequiredError;vnstock keyscho biết phiên còn hạn tới lúc nào.fhsc: ngoài khoảng 06:00 tới 21:00 giờ Việt Nam, nguồn trả lỗi tạm thời (VNSTOCK_SOURCE_UNAVAILABLE). Hạn mức tính theo trọng số mỗi phút.fmp: gói Basic giới hạn 250 lời gọi mỗi ngày; nhiều dữ liệu cần gói trả phí. vnstock không giới hạn thêm: gói của bạn hỗ trợ gì thì dùng được đó. Đăng ký gói của FMP qua link giới thiệu của vnstock được giảm 20%, và vnstock nhận hoa hồng từ FMP.binance: cổng thị trường giao ngay không cần khoá; hạn mức tính theo địa chỉ IP. Mã cặp viết liền:BTCUSDT.- Số bản ghi mỗi lần gọi do nguồn quy định. vnstock không vượt giới hạn đó; kết quả dài được lấy bằng nhiều lời gọi.
Điều khoản
vnstock-oapi terms <nguồn>from vnstock import provenance
provenance.terms(df)Quyền truy cập, lưu trữ, hiển thị và chia sẻ dữ liệu do điều khoản của từng nguồn quy định. Không chia sẻ khoá với người khác. Khi bản tóm tắt và văn bản gốc khác nhau, áp dụng văn bản gốc đang có hiệu lực.