Vnstock Logo

Biến ý tưởng đầu tưthành ứng dụng với AI.

Thư viện Python truy vấn dữ liệu và chuẩn hoá thành bảng, kèm bộ hướng dẫn để trợ lý AI viết chương trình cho bạn.

lượt tải trên PyPI
1.8M+lượt tải trên PyPI
GitHub stars
1.4KGitHub stars
lượt tải tháng cao điểm
400Klượt tải tháng cao điểm
portfolio-analysis
Ask anything, @ to mention, / for actions
+ Gemini 3.1 Pro (High)

Minh hoạ giao diện — số liệu không phải dữ liệu thật.

02 · Làm việc với AI

Bạn ra đề bài, AI viết code, Vnstock chuẩn hoá kết quả.

Không cần thành thạo lập trình để bắt đầu. Agent Skills giúp trợ lý AI hiểu Vnstock và biến câu hỏi đầu tư thành chương trình kiểm chứng được.

  1. 01
    Bạn

    Mô tả ý tưởng bằng tiếng Việt

    “Tìm cổ phiếu ngân hàng có P/B dưới 1.2 và ROE trên 15%, vẽ biểu đồ so sánh 3 năm.”

  2. 02
    AI

    AI lập kế hoạch theo Agent Skills

    Bộ chỉ dẫn mô tả từng nhóm lệnh, tham số và giới hạn, để AI bám sát tài liệu thay vì đoán.

  3. 03
    Vnstock

    Python truy vấn và chuẩn hoá

    Đoạn lệnh do AI viết chạy trên máy bạn, gửi truy vấn tới nguồn bạn chọn rồi chuẩn hoá kết quả.

  4. 04
    Bạn

    Bạn kiểm tra và quyết định

    Kết quả do AI tạo ra có thể sai. Bạn đọc mã, đối chiếu với nguồn chính thức rồi mới quyết định.

Hoạt động vớiClaude CodeChatGPTAntigravityCursor
Nội dung do AI tạo ra có tính xác suất: trợ lý có thể dùng sai hàm, chọn sai tham số hoặc kết luận thiếu căn cứ ngay cả khi trình bày rất thuyết phục.Đọc tiếp
Agent Skills chỉ giúp trợ lý hiểu cách gọi lệnh, không biến kết quả thành kết quả đã được Vnstock kiểm định.

03 · Định vị

Phần mềm chạy trên máy của bạn, truy vấn thẳng tới nguồn.

Xem chi tiết nguyên lý hoạt động

Thư viện chạy trên thiết bị hoặc máy chủ của bạn: yêu cầu đi thẳng tới nguồn bạn chọn, kết quả trả về ngay tại đó. Dữ liệu thị trường không đi qua máy chủ trung chuyển của Vnstock.

Phần Vnstock làm — chặng 02 và 03

  1. 01

    Nguồn bên thứ ba

    Công ty chứng khoán, trang tin tài chính, website doanh nghiệp, nguồn vĩ mô và quốc tế — mỗi nguồn có điều kiện sử dụng riêng do chính nguồn quy định.

  2. 02

    Kết nối trực tiếp

    Yêu cầu đi thẳng từ thiết bị hoặc máy chủ của bạn tới nguồn, không qua máy chủ trung chuyển của Vnstock.

  3. 03

    Chuẩn hoá

    Ép kiểu, đồng bộ đơn vị và đặt tên cột thống nhất. Mỗi nhóm dữ liệu chuẩn hoá theo quy ước riêng phù hợp với loại thông tin đó.

  4. 04

    Đầu ra của bạn

    pandas DataFrame, CSV · Parquet · DuckDB, hoặc đầu vào cho trợ lý AI — bạn toàn quyền quyết định.

Vnstock không làm những việc này

  • Không vận hành kho dữ liệu thị trường để bán lại hay phân phối nội dung nguồn.
  • Không bán dữ liệu và không bán lại quyền truy cập nguồn. Giấy phép phần mềm không đồng thời cấp quyền sử dụng dữ liệu.
  • Không đưa ra tư vấn, khuyến nghị mua bán hay dự báo giá.
  • Không thay bạn kiểm tra quyền truy cập và điều khoản của nguồn đích.

04 · Phạm vi lệnh

Bảy nhóm lệnh, một cách gọi.

Xem toàn bộ tài liệu nhóm lệnh
  • Reference

    Hơn 1.600 mã niêm yết kèm phân ngành ICB, hồ sơ doanh nghiệp, cơ cấu cổ đông, thành phần rổ chỉ số và lịch sự kiện.

    Reference().equity.list_by_industry()
  • Market

    Giá lịch sử đa khung thời gian, khớp lệnh trong phiên, sổ lệnh, giao dịch khối ngoại và tự doanh.

    Market().equity(symbol).ohlcv()
  • Fundamental

    Ba báo cáo tài chính, tỷ số định giá, thuyết minh và hồ sơ công bố theo quý hoặc năm.

    Fundamental().equity(symbol).ratio()
  • Macro

    Insider

    Chỉ tiêu kinh tế Việt Nam, lãi suất, tỷ giá, giá hàng hoá và các mốc vĩ mô toàn cầu.

    Macro().economy().cpi()
  • Insights

    Insider

    Xếp hạng theo giá, khối lượng và khối ngoại, bộ lọc đa tiêu chí, độ rộng thị trường, dòng tiền theo ngành.

    Insights().ranking.gainer()
  • Analytics

    Insider

    Lịch sử P/E, P/B của VNINDEX, VN30 và từng mã qua nhiều chu kỳ, kèm dải định giá.

    Analytics().valuation(index).pe()
  • Retail

    Giá vàng miếng và vàng nhẫn theo từng nhà niêm yết, cùng tỷ giá ngoại tệ ngân hàng.

    Retail().gold(source, date)
  • Đây là phạm vi lệnh của phần mềm, không phải kho dữ liệu của Vnstock.Đọc tiếp
    Phạm vi, độ trễ, tính sẵn có và điều kiện sử dụng phụ thuộc vào từng nguồn — mỗi nhóm ghi rõ nguồn hỗ trợ trong tài liệu. Quyền đối với dữ liệu thuộc về chủ thể có quyền tương ứng; giấy phép phần mềm Vnstock không đồng thời cấp quyền sử dụng dữ liệu của nguồn.

05 · Cấp quyền

Bản Cộng đồng để làm quen. Phân tích chuyên sâu cần bộ công cụ dành cho nhà tài trợ.

Hai bên không khác nhau ở số lượng tính năng mà khác nhau ở phạm vi. Dưới đây là bốn trục quyết định; bảng đối chiếu đầy đủ nằm ở trang gói tài trợ.

Miễn phí

Phiên bản Cộng đồng

Một thư viện, đủ để thử xem phương pháp có hợp với bạn không.

Thư viện
Một thư viện vnstock, mã nguồn công khai
Hạn mức gọi
60 lượt mỗi phút
Agent Skills
6 kỹ năng công khai
Giấy phép
Cá nhân, học tập, nghiên cứu

Bốn gói tài trợ

Thành viên tài trợ

Bốn thư viện, hạn mức gấp 3 đến 10 lần, và dữ liệu trong phiên theo luồng từ gói Golden.

Thư viện
Thêm vnstock_data, vnstock_ta, vnstock_news vnstock_pipeline
Hạn mức gọi
180 đến 600 lượt mỗi phút, tuỳ gói
Agent Skills
Thêm 3 kỹ năng từ Silver, 11 từ Golden, 12 ở Diamond
Dữ liệu trong phiên
Kết nối WSS giữ liên tục — có ở gói Golden và Diamond

Còn tốc độ xử lý song song, nội dung dành riêng cho thành viên, số thiết bị và điều kiện triển khai, giấy phép thương mại và mức hỗ trợ. Chín trục đối chiếu đầy đủ nằm ở trang gói tài trợ.

Phần truy vấn bạn viết trên bản Cộng đồng chuyển sang vnstock_data chỉ bằng một dòng đổi lệnh import; các thư viện còn lại là công cụ riêng, dùng thêm chứ không thay thế.Đọc tiếp
Bản Cộng đồng chỉ dành cho cá nhân, học tập và nghiên cứu; mục đích thương mại hoặc phát sinh doanh thu phải qua gói Diamond và có chấp thuận của tác giả. Quyền sử dụng phần mềm dành cho nhà tài trợ có tính chất tạm thời, không độc quyền, không thể chuyển nhượng và chỉ có hiệu lực khi khoản tài trợ còn hiệu lực. Tích hợp vào sản phẩm thương mại cần thoả thuận cấp phép phần mềm bằng văn bản; thoả thuận đó cũng không thay thế quyền sử dụng hay phân phối dữ liệu của nguồn bên thứ ba.

06 · Đánh giá

Người dùng nói gì sau khi đưa Vnstock vào việc thật.

Giảng viên, nhà phân tích, người làm sản phẩm và sinh viên — mỗi người dùng Vnstock cho một việc khác nhau.

  • Rất cám ơn Thịnh đã tạo ra một app vô cùng ấn tượng và có ích, không chỉ cho trading mà còn cho cả mục đích cung câp số liệu cho các hoạt động nghiên cứu và giảng dạy.
    LLê Hải TrungPGS, Tiến sĩ, Giảng viên Học Viện Ngân Hàng, HN
  • Sau khi học xong khóa học, tôi đã biết cách áp dụng những kiến thức vào việc tạo ra web app theo ý tưởng riêng, thiết kế các hệ thống mà trước giờ toàn phải làm tay, hoặc làm trên excel rất bất tiện và không đẹp mắt.
    KKhưu Bảo KhánhFounder Kakata.vn, TP. HCM
  • Học 1 khóa mà bất ngờ với bộ tài liệu, bài tập, giáo trình và các công cụ vì rất đầy đủ, bài bản và sắp xếp sạch sẽ, đem nghiên cứu lâu dài được. Recommend mạnh 😃
    TTrương Đắc NguyênTrưởng phòng khách hàng trực tuyến, Chứng khoán Rồng Việt
  • Năm ngoái có sinh viên của mình dùng vnstock trong khóa luận tốt nghiệp. Cá nhân mình cảm thấy gói vnstock của anh Thịnh phát triển rất hay và phù hợp với lĩnh vực đào tạo trong ngành Fintech của mình.
    PPhan Huy TâmGiảng viên Đại Học Kinh Tế - Luật, HCM
  • Vnstock giúp em dễ dàng lấy dữ liệu thị trường chứng khoán tại Việt Nam... góp phần quan trọng trong việc giúp em và nhóm giành giải quán quân cuộc thi Attacker tại Đại học Kinh Tế - Luật Tp. HCM.
    NNhật HoaSinh viên, Đại học Ngân Hàng
  • Điều khó khăn nhất của mình lúc bấy giờ là tìm công cụ kết nối dữ liệu... Vnstock giúp kết nối dữ liệu giá lịch sử nhanh chóng, kịp thời và có độ chính xác khá cao.
    TThái Tuấn KhaChuyên viên phân tích định lượng, Chứng khoán Bảo Việt

Đọc thêm nhận xét

07 · Cộng đồng

Được dùng và kiểm chứng bởi cộng đồng, từ 2022.

Mã nguồn công khai, tài liệu tiếng Việt, và một cộng đồng trả lời câu hỏi mỗi ngày. Bắt đầu bằng vài dòng lệnh — không cần đăng ký.

Lượt tải về (từ 2022)
1.8MLượt tải vềtừ 2022
Lượt tải (tháng cao điểm)
400KLượt tảitháng cao điểm
GitHub stars (đến 09/2026)
1.4KGitHub starsđến 09/2026
Thư viện (trong hệ sinh thái)
4Thư việntrong hệ sinh thái