Vnstock Logo

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.

Ủy Quyền Cho AI
Cách 1: Nạp Agent Guide

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.

Sử Dụng Trực Tiếp
Cách 2: Giao diện Hợp nhất (Khuyên dùng)

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ế.

Kiểm Soát Cấp Thấp
Cách 3: Bộ định tuyến API (Adapter)

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ách 1: Nạp Agent Guide cho AI (Zero-code)
Bỏ qua mọi rào cản về lập trình. Bạn tận dụng AI làm "trợ lý phân tích", chỉ việc cung cấp tài liệu hướng dẫn chuẩn của Vnstock và đưa ra yêu cầu.
1

Cài đặt phần mềm hỗ trợ AI Agent như Google Antigravity (khuyên dùng), Claude Code, Cursor, Windsurf.

2

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.

3

Mở ứng dụng AI IDE, chọn mở thư mục vừa giải nén để bắt đầu dự án.

4

Mở khung chat của AI và ra lệnh:

"Dựa vào cấu trúc tài liệu hiện có, hãy viết script Python tải lịch sử giá cổ phiếu FPT"

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.

Hướng dẫn tải tài liệu Agent Guide bằng file ZIP trên Github

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.

Reference Layer

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.

Market Layer

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.

Fundamental Layer

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á.

Macro Layer

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.

Insights Layer

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.

Analytics Layer

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.