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: Giao tiếp chung (Core 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: Để trợ lý AI đọc Agent Guide (không cần code)
Bạn mô tả việc bằng tiếng Việt, trợ lý viết code. Bốn bước tải ZIP từ GitHub rồi giải nén trước đây đã bỏ: trợ lý đọc chỉ dẫn thẳng từ web trong lúc làm việc, nên không có tệp nào nằm trên máy để mà cũ đi.
1

Mở một trợ lý AI bạn đang dùng — Claude, ChatGPT, Antigravity hay công cụ khác đều được.

2

Dán câu kích hoạt lấy ở Agent Guide. Trợ lý đọc bản chỉ dẫn từ vnstocks.com và tự dựng môi trường.

3

Nói việc cần làm, bằng tiếng Việt:

"Viết script Python tải lịch sử giá cổ phiếu FPT một năm gần nhất"

Trợ lý tra tài liệu đang phát hành để viết đúng cú pháp, chạy thử và trả kết quả. Có bản thư viện mới thì lần chạy kế tiếp đã dùng bản mới, bạn không phải làm gì.

Chưa rõ vibe coding là gì? Đọc tầng 1 trước khi kích hoạ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.