Thinh Vu Blog
Mạch Nguồn Số

API chứng khoán và hành trình của Vnstock: từ thư viện Python đến hệ sinh thái nghiên cứu đầu tư

22 tháng 9, 2022Bình luận
API chứng khoán và hành trình của Vnstock: từ thư viện Python đến hệ sinh thái nghiên cứu đầu tư

Bài viết này ra đời năm 2022 để giới thiệu thư viện vnstock. Bốn năm sau, Vnstock đã khác nhiều, nên mình viết lại: kể ngắn thời gian đầu, Vnstock hôm nay tập trung vào việc gì, và vài điều nên biết nếu bạn đang tìm hiểu về API chứng khoán.

1. Thời gian đầu (2021–2022)

Năm 2021, mình bắt đầu tự nghiên cứu cổ phiếu và nhanh chóng mất nhiều buổi tối cho việc chép số liệu từ trang web sang bảng tính. Là người làm dữ liệu, mình viết vài đoạn Python để bớt phần việc lặp lại ấy, rồi gom lại thành thư viện vnstock, lấy cảm hứng từ investpy. Phiên bản đầu tiên ra mắt ngày 27/02/2022, với một triết lý đơn giản: “Đơn giản, dùng tốt, và có tính lâu dài”.

Các phiên bản đầu công khai mã nguồn trên GitHub. Từ thế hệ 5, thư viện phát hành dạng đóng gói sẵn và dùng theo Giấy phép sử dụng Vnstock.

2. Vnstock hôm nay: hệ sinh thái nghiên cứu đầu tư

Sau bốn năm, mình nhận ra phần tốn công nhất của việc nghiên cứu không nằm ở chỗ có số liệu. Nó nằm ở những việc sau đó: đưa số liệu về cùng một cấu trúc, tính chỉ số mà biết rõ công thức, kiểm tra lại khi hai bảng nói hai điều khác nhau, và tuần sau chạy lại được mà không phải làm từ đầu.

Vì thế Vnstock đi theo hướng hệ sinh thái tự động hoá cá nhân trong nghiên cứu đầu tư: bộ công cụ Python chạy trên máy của bạn, tài liệu để trợ lý AI viết mã đúng, và một cộng đồng những người thích tự làm công cụ cho mình.

  • Vnstock Quant: tính toán định lượng trên dữ liệu của bạn: chỉ báo kỹ thuật, chỉ số tài chính, đo rủi ro và hiệu suất, danh mục, định giá. Công thức nào cũng có trong tài liệu.
  • Vnstock Pipeline: sắp xếp dữ liệu nghiên cứu trên máy của bạn: tải theo lô, kiểm tra chất lượng, lưu có tổ chức và xuất sang định dạng phân tích quen dùng.
  • Vnstock News: theo dõi tin tài chính từ nguồn cấp tin các toà soạn công bố, sắp xếp tiêu đề, thời gian và đường dẫn để bạn đọc bài tại trang gốc.
  • Vnstock MCP: lớp công cụ để trợ lý AI gọi các chức năng được phép trong môi trường do bạn kiểm soát.
  • Agent Skills: bộ hướng dẫn giúp trợ lý AI hiểu đúng hàm, đúng tham số của Vnstock.
  • vnstock: thư viện chính, chuẩn hoá dữ liệu thị trường về một cấu trúc chung để các công cụ trên dùng tiếp.

Cách làm việc mình hướng tới gói trong một câu: bạn nêu bài toán, trợ lý AI giúp viết mã, cách làm được giữ lại trên máy của bạn. Bạn không cần biết lập trình trước để bắt đầu.

Bản Cộng đồng miễn phí cho cá nhân, học tập và nghiên cứu. Gói quyền sử dụng Vnstock mở rộng hạn mức và tính năng theo phạm vi công bố trên vnstocks.com.

Vnstock không làm: không bán dữ liệu thị trường, không đưa khuyến nghị mua bán, không bảo đảm thay cho nguồn về độ chính xác hay tính liên tục của dữ liệu.

3. Về API chứng khoán: những gì đang có trên thị trường

Nhiều người tìm tới bài này với từ khoá “API chứng khoán”. Hiện nay một số công ty chứng khoán tại Việt Nam có kênh kết nối dành cho khách hàng mở tài khoản, thường ở hai dạng:

  • Open API: cho phần mềm của bạn kết nối với tài khoản và thông tin thị trường theo điều kiện của tài khoản. Thường cần đăng ký, được cấp khoá truy cập và đồng ý điều khoản riêng.
  • Máy chủ MCP: cho trợ lý AI như Claude hay ChatGPT tra cứu thông tin ngay trong cuộc trò chuyện, sau khi bạn cấp quyền.

Muốn biết công ty bạn sử dụng có kênh nào, bạn xem mục dành cho nhà phát triển trên trang của công ty nơi bạn mở tài khoản, hoặc hỏi bộ phận hỗ trợ của họ.

Trước khi dùng, nên kiểm tra bốn điều:

  1. Điều khoản sử dụng: dữ liệu chỉ dùng cho cá nhân, hay được hiển thị và chia sẻ lại.
  2. Hạn mức và phí: số lượt gọi, giới hạn theo gói tài khoản, thường các dịch vụ này đang miễn phí cho khách hàng.
  3. Phạm vi quyền: kênh chỉ đọc thông tin hay có thao tác trên tài khoản. Khi kết nối với trợ lý AI, hãy bắt đầu từ quyền chỉ đọc.
  4. Giữ khoá truy cập an toàn: lưu trong tệp .env hoặc trình quản lý bí mật, không dán vào cuộc trò chuyện, không đẩy lên GitHub.

Các API và máy chủ MCP này do từng công ty chứng khoán vận hành và quy định điều kiện. Vnstock không liên kết với, và không đại diện cho, đơn vị nào trong số đó.

4. Bắt đầu từ đâu

Chỉ các địa chỉ dưới đây là kênh chính thức của Vnstock:

Hướng dẫn nhanh

Vnstock là hệ sinh thái tự động hoá cá nhân trong nghiên cứu đầu tư, chạy trên máy của bạn. Vnstock cấp quyền dùng phần mềm, không bán dữ liệu; dữ liệu có sẵn và chính xác tới đâu là do nguồn. Nội dung phục vụ nghiên cứu và tham khảo, không phải khuyến nghị đầu tư.

Thẻ

stock-market
automation
data-science

Bình luận

Đang tải bình luận...