Lịch sử phiên bản
02-11-2024
Phát hành chính thức phiên bản v3.0.9 qua PyPI.
Cài đặt với câu lệnh: pip install -U vnstock3
trên máy của bạn.
- Nâng cấp hàm truy xuất dữ liệu từ nguồn VCI cho báo cáo tài chính. Lọc các cột dữ liệu không liên quan, trùng lặp xuất hiện trong các phiên bản trước đó. Chỉ tập trung các giá trị dữ liệu cho đúng loại hình công ty của mã bạn tra cứu. Có 4 nhóm công ty bao gồm Công ty phổ thông, Ngân hàng, Chứng khoán, Bảo hiểm.
- Sửa lỗi chuyển đổi nhanh mã cổ phiếu. Cho phép cài đặt tham số
symbol
khi gọi hàm với cú phápstock.finance(symbol='TCB')
. Việc này giúp bạn không cần phải cập nhật mã symbol khi khởi tạo class mà có thể thayd đổi trong method gọi dữ liệu cụ thể. Thay đổi này sau đó sẽ áp dụng cho class trong các hàm tiếp theo. - Bổ sung thêm tuỳ chọn tham số
show_log
trong các class của Vnstock, bạn có thể tắt log message (các hiển thị cảnh báo) bằng cách đặtshow_log=False
. - Khắc phục lỗi định dạng
NoneType Object
khi không nhập mã chứng khoán trong Listing class với câu lệnh:
from vnstock3 import Vnstock
stock = Vnstock().stock(source='VCI')
- Khắc phục lỗi 404 khi truy cập dữ liệu giá từ module Quote của VCI do API url thay đổi.
- Khắc phục lỗi không nhận diện các mã chỉ số khi tra cứu lịch sử giá từ module Quote.history. Các mã chỉ số chuẩn sử dụng cho tra cứu thị trường chứng khoán Việt Nam gồm: VNINDEX, HNXINDEX, UPCOMINDEX
- Bổ sung khả năng lấy dữ liệu giá lịch sử cho Trái phiếu niêm yết & nâng cấp cơ chế nhận diện loại tài sản với khả năng nhận diện mã nhập vào là Trái phiếu.
15-10-2024
Cập nhật phiên bản mới, gỡ lỗi một số vấn đề phát sinh được báo lỗi: -Lỗi khi gọi lịch sử giá: issue 147
- Bổ sung cơ chế báo lỗi khi dữ liệu trả về không như mong muốn với BCTC: issue 133
12-08-2024
Cập nhật mã nguồn phiên bản 0.3.0.7
- Sửa lỗi mốc thời gian giá lịch sử không ổn định. Hiện tại có thể lấy thông tin giá lịch sử thuộc tất cả các khung thời gian với tham số
end
là ngày hiện tại. Mã báo lỗi 135: tại đây - Bổ sung cơ chế xử lý lỗi khi thông tin
event_desc
trả về trong DataFrame không chứa thành phần HTML cần chuyển đổi thành văn bản. Mã báo lỗi 141 tại đây - Sửa lỗi & cải thiện phương thức lấy dữ liệu báo cáo tài chính từ VCI:
- Sửa lỗi tên biến UNIT_MAPPING không khớp
- Tự động loại bỏ dữ liệu N/A trong báo cáo tài chính. Việc này giúp loại bỏ các dữ liệu không có ý nghĩa và trùng lặp tên cột. Bạn có thể tuỳ chỉnh sử dụng tham số dropna=False để chỉ định giữ lại dữ liệu nguyên bản (có thể trùng lặp tên cột - khác ý nghĩa dữ liệu) và N/A.
- Hỗ trợ API đặt lệnh từ Vnstock Python sử dụng bộ API từ DNSE. Mã nguồn được kế thừa từ phiên bản Vnstock Legacy. Chi tiết tại đây
- Bổ sung thông tin gói phụ thuộc
- Bổ sung phiên bản cố định cho các gói phụ thuộc vào file requirements.txt
- Bổ sung
seaborn
vào danh sách gói phụ thuộc để loại bỏ lỗi khi cài đặt trên máy tính mới không có sẵnseaborn
.
10-07-2024
Cập nhật mã nguồn phiên bản 0.3.0.6
- Chuyển đổi mã nguồn Vnstock Legacy sang Vnstock3 cho bộ công cụ gửi tin nhắn qua Telegram, Lark, Slack tại đây.
- Chuyển đổi mã nguồn module
fund.py
từ Vnstock Legacy sang Vnstock3 tại đây. - Loại bỏ cơ chế bắt buộc người dùng chấp nhận điều khoản, điều kiện rõ ràng. Mặc định, bạn chấp nhận điều khoản & điều kiện khi tiếp tục sử dụng Vnstock3.
- Sửa lỗi và cải thiện trải nghiệm:
21-06-2024
Cập nhật phiên bản 0.3.0.5
- Sửa lỗi không hiển thị đúng múi giờ trong thời gian của bảng giá lịch sử với khung thời gian giờ và phút, chi tiết issue tại đây
- Sửa lỗi không cho phép truy xuất thông tin giá từ TCBS nếu
symbol
không phải là mã cổ phiếu. Chi tiết issue tại đây - Bổ sung xác thực thông tin nhập liệu cho hàm
history
- Thời gian bắt đầu phải nhỏ hơn thời gian kết thúc.
03-06-2024
Cập nhật phiên bản 0.3.0.3
- Tích hợp khả năng biểu diễn dữ liệu của vnstock_ezchart trực tiếp vào thư viện. Chi tiết tại đây
- Tách riêng notebook min hoạ theo chủ đề. Chi tiết tại đây
- Cập nhật hàm truy xuất api_key từ nguồn dữ liệu MSN, khắc phục lỗi truy xuất dữ liệu các loại chứng khoán quốc tế.
- Cập nhật nội dung phản ánh các thay đổi của dự án trên Website.
25-05-2024
Hoàn thiện tính năng, sửa lỗi và bổ sung tài liệu hướng dẫn.
-
Sửa lỗi tự động ghi đè thông tin mã cổ phiếu theo mã báo lỗi 9547585
-
Hoàn thiện nhóm hàm chức năng truy xuất dữ liệu tài chính. Hiện tại có thể gọi thuộc tính
finance
từ lớp Vnstock() thay vì gọi hàm từ trực tiếp nguồn dữ liệu kiểuvnstock3.explorer.vci.finance
. -
Cập nhật hàm minh hoạ trong Demo Notebook.
-
Bổ sung tài liệu hướng dẫn chi tiết
-
Dành cho nhóm phát triển:
- Bổ sung cấu trúc thư mục
tests
dùng cho việc kiểm thử gói phần mềm.
- Bổ sung cấu trúc thư mục
10-05-2024
Ra mắt phiên bản Vnstock thế hệ thứ 3 - Vnstock3.
23-01-2024
Cập nhật thay đổi từ ngày 16/12/2023 ở phiên bản beta
sang main
và phát hành chính thức phiên bản 2.8.8.
- Cập nhật mã nguồn hàm
financial_report
sửa lỗi triệt để lỗi sử dụng 'Excel file format cannot be determined, you must specify an engine manually' do dữ liệu trả về không phải định dạng Excel.- Nguồn dữ liệu từ Fiintrade của SSI sử dụng mã
OrganCode
để tra cứu thông tin công ty trong đó có báo cáo tài chính. Có khoảng > 600 mã cổ phiếu có mã symbol khác OrganCode do đó có nhiều mã khi tra cứu BCTC với mã symbol sẽ gây ra rỗi trong khi với các mã khác thì không. Ví dụYTC
có OrganCode làYTECO
dùng để tra cứu BCTC. - Bổ sung
openpyxl
là gói phụ thuộc để đọc dữ li ệu trả về từ API dưới dạng file Excel. Lỗi này xảy ra khi cài bản Python thuần. Không gặp lỗi với Google Colab hoặc Anaconda.
- Nguồn dữ liệu từ Fiintrade của SSI sử dụng mã
- Sửa lỗi vnstock web app
21-01-2024
- Bổ sung tích hợp cho phép sử dụng các hàm gửi tin nhắn từ vnstock qua Telegram/Slack với các channel/group chat được cài đặt.
- Cập nhật nội dung trang tài liệu
- Khởi động dự án vnstock-next cho thế hệ phần mềm vnstock tiếp theo.
03-01-2024
-
Cập nhật khung chương trình khóa học Python 5 khai giảng 21/1/2024
-
Bổ sung tính năng hiện banner thông báo quan trọng trên trang tài liệu.
02-01-2024
- Bổ sung tính năng OCR sử dụng Pytesseract cho vnstock và vnstock-data-pro. Chi tiết tại đây
24-12-2023
- Cập nhật tài liệu dự án
- Tài liệu truy xuất giá lịch sử
- Hướng dẫn truy xuất dữ liệu giao dịch nước ngoài/tự doanh sử dụng gói phần mềm
vnstock-data-pro
- Hướng dẫn nhanh
16-12-2023
-
Cập nhật tài liệu dự án
-
Bổ sung
requirements.txt
cho trình tạo trang tĩnh MKDocs giúp cài đặt gói phụ thuộc để thiết lập trang tài liệu và xem trước dễ dàng.
14-12-2023
Chính thức phát hành các thay đổi từ nhánh Beta trong phiên bản 2.8.7. Chi tiết cập nhật qua blog: tại đây
-
Ra mắt Vnstock Insiders Program cung cấp quyền truy cập tới các kho chứa mã nguồn riêng tư (private repo)
-
Ra mắt
vnstock-pro-data
trong chương trình Insiders, cung cấp khả năng truy cập dữ liệu chất lượng cao với độ trễ thấp.- Tải dữ liệu giá OHLCV nhanh chóng, chính xác không cần xác thực qua Public API của SSI.
- Tải và streaming dữ liệu qua SSI Fast Connect API chính thức (cần đăng ký và xác thực người dùng)
-
Chính thức phát hành tính năng truy cập dữ liệu quỹ mở. Hướng dẫn tại đây
-
Hỗ trợ xuất dữ liệu time series cho OpenBB Terminal. Hướng dẫn tại đây
-
Cập nhật tài liệu dự án
10-12-2023
- Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do
andrey_jef
đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng. - Đưa
plotly
thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Việc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêmplotly
theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới. - Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu gi á lịch sử.
- Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.
02-04-2024
Cập nhật tài liệu hướng dẫn và sửa đổi nhỏ cho hàm gửi tin nhắn Telegram.
23-01-2024
Cập nhật thay đổi từ ngày 16/12/2023 ở phiên bản beta
sang main
và phát hành chính thức phiên bản 0.2.8.8.
- Cập nhật mã nguồn hàm
financial_report
sửa lỗi triệt để lỗi sử dụng 'Excel file format cannot be determined, you must specify an engine manually' do dữ liệu trả về không phải định dạng Excel.- Nguồn dữ liệu từ Fiintrade của SSI sử dụng mã
OrganCode
để tra cứu thông tin công ty trong đó có báo cáo tài chính. Có khoảng > 600 mã cổ phiếu có mã symbol khác OrganCode do đó có nhiều mã khi tra cứu BCTC với mã symbol sẽ gây ra rỗi trong khi với các mã khác thì không. Ví dụYTC
có OrganCode làYTECO
dùng để tra cứu BCTC. - Bổ sung
openpyxl
là gói phụ thuộc để đọc dữ liệu trả về từ API dưới dạng file Excel. Lỗi này xảy ra khi cài bản Python thuần. Không gặp lỗi với Google Colab hoặc Anaconda.
- Nguồn dữ liệu từ Fiintrade của SSI sử dụng mã
- Sửa lỗi vnstock web app
21-1-2024
- Bổ sung tích hợp cho phép sử dụng các hàm gửi tin nhắn từ vnstock qua Telegram/Slack với các channel/group chat được cài đặt.
- Cập nhật nội dung trang tài liệu
- Khởi động dự án vnstock-next cho thế hệ phần mềm vnstock tiếp theo.
03-01-2024
-
Cập nhật khung chương trình khóa học Python 5 khai giảng 21/1/2024
-
Bổ sung tính năng hiện banner thông báo quan trọng trên trang tài liệu.
02-01-2024
- Bổ sung tính năng OCR sử dụng Pytesseract cho vnstock và vnstock-data-pro. Chi tiết tại đây
24-12-2023
- Cập nhật tài liệu dự án
- Tài liệu truy xuất giá lịch sử
- Hướng dẫn truy xuất dữ liệu giao dịch nước ngoài/tự doanh sử dụng gói phần mềm
vnstock-data-pro
- Hướng dẫn nhanh
16-12-2023
-
Cập nhật tài liệu dự án
-
Bổ sung
requirements.txt
cho trình tạo trang tĩnh MKDocs giúp cài đặt gói phụ thuộc để thiết lập trang tài liệu và xem trước dễ dàng.
14-12-2023
Chính thức phát hành các thay đổi từ nhánh Beta trong phiên bản 2.8.7. Chi tiết cập nhật qua blog: tại đây
-
Ra mắt Vnstock Insiders Program cung cấp quyền truy cập tới các kho chứa mã nguồn riêng tư (private repo)
-
Ra mắt
vnstock-pro-data
trong chương trình Insiders, cung cấp khả năng truy cập dữ liệu chất lượng cao với độ trễ thấp.- Tải dữ liệu giá OHLCV nhanh chóng, chính xác không cần xác thực qua Public API của SSI.
- Tải và streaming dữ liệu qua SSI Fast Connect API chính thức (cần đăng ký và xác thực người dùng)
-
Chính thức phát hành tính năng truy cập dữ liệu quỹ mở. Hướng dẫn tại đây
-
Hỗ trợ xuất dữ liệu time series cho OpenBB Terminal. Hướng dẫn tại đây
-
Cập nhật tài liệu dự án
10-12-2023
- Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do
andrey_jef
đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng. - Đưa
plotly
thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Việc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêmplotly
theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới. - Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu giá lịch sử.
- Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.
10-12-2023
- Bổ sung tính năng truy xuất dữ liệu quỹ mở từ fmarket.vn, phát triển từ mã nguồn do
andrey_jef
đóng góp. Tài liệu mô tả và demo notebook đã được cập nhật tương ứng. - Đưa
plotly
thành thư viện tùy chọn, chỉ phải import vào dự án nếu người dùng có nhu cầu sử dụng tính năng vẽ đồ thị. Vi ệc này giúp vnstock chạy trên môi trường khác Google Colab không cần cài đặt thêmplotly
theo mặc định. Mã nguồn được cập nhật lên bản beta trên Github, thay đổi sẽ được đẩy lên PyPI trong tuần tới. - Cập nhật tài liệu hướng dẫn cho nội dung lấy dữ liệu giá lịch sử.
- Cập nhật tài liệu hướng dẫn cách cài đặt thư viện TA-Lib cho phân tích kỹ thuật trên máy tính Windows.
09-11-2023
Phát hành phiên bản 0.2.8.5
- Cập nhật hàm
stock_intraday_data
- Bổ sung tham số
investor_segment
, mặc định nhận giá trịTrue
cho phép trả về dữ liệu khớp lệnh theo phân nhóm nhà đầu tư (như các phiên bản trước), khi đặt làFalse
cho phép trả về dữ liệu thô, không gộp thông tin lệnh theo phân nhóm.
- Bổ sung tham số
- Bổ sung hàm
amibroker_ohlc_export
cho phép xuất dữ liệu sang định dạng CSV để nạp dữ liệu cho Amibroker. Chi tiết tại đây - Bổ sung hướng dẫn tích hợp vnstock với dự án sử dụng thư viện phân tích kỹ thuật TA-lib python. Chi tiết tại đây
- Giới thiệu một số thư viện Backtesting trong python giúp kiểm thử chiến lược giao dịch. Chi tiết tại đây
08-11-2023
Phát hành phiên bản 0.2.8.4
-
Tùy biến hàm
stock_historical_data
giúp dễ dàng sử dụng với các thư viện phân tích kỹ thuật khác trong Python.-
Thêm tham số
decor
, nhận giá trị mặc định làFalse
(không thay đổi dữ liệu trả về với cách sử dụng hiện tại của người dùng). Khi đặtdecor=True
, áp dụng thay tên các cột trong DataFrame trả về dưới dạng Title Case tứcOpen, High, Low, Close, Time, Ticker
thay vìopen, high, low, close, time, ticker
như hiện tại đồng thời đặt cột Time là index. Việc này giảm bớt cho người dùng phải viết thêm câu lệnh khi sử dụng dữ liệu vnstock kết hợp các thư viện phân tích kỹ thuật phổ biến vốn dùng thư viện Yahoo Finance làm nguồn cấp dữ liệu. -
Bổ sung tham số
source
cho phép chọn nguồn tải dữ liệu làTCBS
hayDNSE
. Nguồn dữ liệuTCBS
cho lấy dữ liệu lịch sử theo ngày (resolution =1D
) trong thời gian dài, không hỗ trợ khung thời gian nhỏ hơn. Trong khi đó nguồn dữ liệuDNSE
cho phép lấy dữ liệu với nhiều khung thời gian khác nhau, giới hạn 90 ngày gần nhất đối với dữ liệu phút, 10 năm gần nhất đối với dữ liệu ngày.
-
-
Cập nhật tcbs_headers sử dụng cho các request đến API của TCBS