Cách Tiếp Cận Thư Viện
Không có một cách dùng duy nhất đúng. Vnstock cung cấp 3 hướng tiếp cận phù hợp với người chưa biết lập trình lẫn chuyên gia phân tích dữ liệu.
Ba cách làm chủ Vnstock
Tùy thuộc vào việc bạn muốn tiết kiệm thời gian hay muốn kiểm soát tối đa, bạn có thể chọn một trong ba cách sau.
Bạn không cần viết một dòng code nào. Chỉ cần đưa tài liệu (Agent Guide) cho AI, đưa ra yêu cầu và nhận thẳng kết quả phân tích.
Cách dùng chính thức được khuyên dùng nhất khi tự viết code. Cú pháp trực quan, phân lớp rõ ràng (Market, Reference...) theo chuẩn quốc tế.
Truy cập sâu vào các lớp chức năng cốt lõi (Quote, Finance). Dành cho người dùng chuyên sâu muốn thao tác trực tiếp với từng nguồn dữ liệu.
Chi tiết các phương pháp
Ví dụ thực tế cho cả ba phương pháp tiếp cận khi lấy dữ liệu giá cổ phiếu.
Cài đặt phần mềm hỗ trợ AI Agent như Google Antigravity (khuyên dùng), Claude Code, Cursor, Windsurf.
Tải Vnstock Agent Guide về máy dưới dạng file ZIP (xem ảnh minh hoạ dưới) và giải nén.
Mở ứng dụng AI IDE, chọn mở thư mục vừa giải nén để bắt đầu dự án.
Mở khung chat của AI và ra lệnh:
Trợ lý AI sẽ tự đọc chỉ dẫn trong thư mục để viết code chuẩn xác, chạy lệnh và trả kết quả cho bạn.

Bạn đã có sẵn môi trường code và thành thạo CLI/Git? Xem hướng dẫn cấu hình chi tiết →
Cấu Trúc Của Giao Diện Hợp Nhất
Thay vì tập trung vào một lớp chức năng khổng lồ, Vnstock chia nhỏ ra thành các Layer dựa trên ngữ cảnh phân tích (Market, Reference, Fundamental...).
Các Phân Lớp Dữ Liệu
Tổng quan 6 nhóm dữ liệu cốt lõi trong kiến trúc Unified UI của Vnstock.
Dữ liệu tham chiếu tĩnh như danh sách cổ phiếu, chỉ số, thông tin hồ sơ công ty, phân ngành, sự kiện.
Dữ liệu diễn biến thị trường thực tế: giá OHLCV, giao dịch trong ngày (intraday), giao dịch khối ngoại.
Sức khoẻ tài chính: Báo cáo tài chính (CĐKT, KQKD, LCTT) và các chỉ số định giá.
Dữ liệu vĩ mô: lãi suất, tỷ giá, lạm phát, giá hàng hoá (vàng, dầu) trên thế giới.
Các công cụ bộ lọc cổ phiếu (screener) dựa trên đa tiêu chí, đánh giá và xếp hạng.
Các thuật toán phân tích kỹ thuật và mô hình thống kê chuyên sâu.
Bạn đã sẵn sàng để khám phá?
Bắt đầu với phương pháp phù hợp với bạn nhất để tối ưu quá trình lấy dữ liệu.