# vnstock-js > vnstock-js là thư viện TypeScript lấy dữ liệu chứng khoán Việt Nam (giá, nến, bảng giá, công ty, tài chính, thị trường, khối ngoại, sàng lọc, chỉ báo, backtest, MCP). Tài liệu này dành cho bản 2.x. Quy tắc quan trọng: - Bản 2.x khác hẳn 1.x: `import { vn } from "vnstock-js"`, không có `init()`, không có default export, không có `stock.quote()`. - Tiền luôn tính bằng đồng: giá `127000` là 127.000 đồng. Không nhân hay chia 1000. - Chỉ số là điểm. `changePct` là phần trăm (`0.95` là 0,95%). Tỷ số tài chính là phân số (`roe: 0.15` là 15%). - Nến có `time` theo giờ Việt Nam, không có `date`. Range: `1d 5d 1mo 3mo 6mo ytd 1y 2y 5y max` (không có `6m`). - Tham số luôn là `symbol`, không phải `ticker`. - Chỉ báo import từ `vnstock-js/indicators`, nhận `Bar[]`, không gọi mạng. - Trình duyệt phải đi qua proxy: `nextHandler()` từ `vnstock-js/proxy` và `createClient({ proxy: "/api/vnstock" })`. - Lỗi có `code` và `hint`; hiển thị `hint` cho người dùng. Toàn bộ tài liệu trong một file: https://vnstock-js-docs.vercel.app/llms-full.txt ## Tài liệu - [Giới Thiệu](https://vnstock-js-docs.vercel.app/md/getting-started/introduction.md): Tổng quan về vnstock-js, thư viện dữ liệu chứng khoán Việt Nam cho JavaScript và TypeScript. - [Cài Đặt](https://vnstock-js-docs.vercel.app/md/getting-started/installation.md): Cài đặt vnstock-js cho Node, serverless, trình duyệt, CLI và MCP. - [Hướng Dẫn Sử Dụng Nhanh](https://vnstock-js-docs.vercel.app/md/getting-started/quick-start-guide.md): Những lời gọi hay dùng nhất của vnstock-js 2.x trong một trang. - [Quy Ước & Đơn Vị](https://vnstock-js-docs.vercel.app/md/getting-started/conventions.md): Đơn vị tiền, chỉ số, phần trăm, thời gian và lỗi trong vnstock-js 2.x. - [Dùng Với AI](https://vnstock-js-docs.vercel.app/md/getting-started/ai.md): Prompt mẫu, file quy tắc cho agent, llms.txt và MCP để AI viết code vnstock-js 2.x đúng ngay lần đầu. - [Kiến Trúc](https://vnstock-js-docs.vercel.app/md/getting-started/architecture.md): Cách vnstock-js 2.x tổ chức client, source, transport, storage và compute. - [Danh Sách Hàm](https://vnstock-js-docs.vercel.app/md/getting-started/api-references.md): Toàn bộ API công khai của vnstock-js 2.x. - [Nâng Cấp Từ v1](https://vnstock-js-docs.vercel.app/md/getting-started/migration.md): Bảng đối chiếu từng lời gọi vnstock-js 1.x sang 2.x và cách đổi đơn vị. - [CLI](https://vnstock-js-docs.vercel.app/md/getting-started/cli.md): Tra cứu giá, lịch sử, thị trường, sàng lọc, backtest và danh mục ngay trên terminal. - [Lịch Sử Phiên Bản](https://vnstock-js-docs.vercel.app/md/getting-started/changelog.md): Các thay đổi qua từng phiên bản vnstock-js - [Câu Hỏi Thường Gặp](https://vnstock-js-docs.vercel.app/md/getting-started/faq.md): Những lưu ý quan trọng khi sử dụng vnstock-js 2.x. - [Cơ Bản](https://vnstock-js-docs.vercel.app/md/key-features/basic.md): Các lời gọi cơ bản của vnstock-js 2.x với đầu ra mẫu. - [Nâng Cao](https://vnstock-js-docs.vercel.app/md/key-features/advanced.md): Các nhóm tính năng của vnstock-js 2.x. - [Bảng Giá - Prices](https://vnstock-js-docs.vercel.app/md/key-features/advanced/trading.md): Giá hiện tại của một hay nhiều mã, top tăng giảm. - [Lịch Sử Giá - History](https://vnstock-js-docs.vercel.app/md/key-features/advanced/quote.md): Nến từ 1 phút tới 1 tháng, range và khoảng ngày, gộp khung trong thư viện. - [Danh Mục Mã - Symbols](https://vnstock-js-docs.vercel.app/md/key-features/advanced/listing.md): Danh sách mã theo sàn, nhóm, ngành. - [Tìm Kiếm - Search](https://vnstock-js-docs.vercel.app/md/key-features/advanced/search.md): Tìm mã theo ký hiệu hoặc tên công ty. - [Tài Chính - Financials](https://vnstock-js-docs.vercel.app/md/key-features/advanced/financials.md): Báo cáo tài chính, tỷ số, hồ sơ công ty, cổ đông, sự kiện. - [Thị Trường - Market](https://vnstock-js-docs.vercel.app/md/key-features/advanced/market.md): Tổng quan thị trường, độ rộng, thanh khoản, khối ngoại và lịch sử khối ngoại, thanh khoản trong phiên. - [Sàng Lọc - Screening](https://vnstock-js-docs.vercel.app/md/key-features/advanced/screening.md): Lọc cổ phiếu theo bảng giá và chỉ số tài chính với where và sort. - [Chỉ Báo & Pattern](https://vnstock-js-docs.vercel.app/md/key-features/advanced/indicators.md): Chỉ báo kỹ thuật, vùng hỗ trợ/kháng cự, mẫu nến, Turtle, breakout, sức khoẻ thị trường. - [AI Context](https://vnstock-js-docs.vercel.app/md/key-features/advanced/ai-context.md): Bối cảnh kỹ thuật tính sẵn cho LLM, dạng JSON hoặc văn bản. - [Danh Mục Đầu Tư](https://vnstock-js-docs.vercel.app/md/key-features/advanced/portfolio.md): Định giá danh mục theo giá hiện tại, nhóm theo môi giới và ngành, lưu và đọc lại. - [Theo Dõi & Cảnh Báo](https://vnstock-js-docs.vercel.app/md/key-features/advanced/realtime.md): Giá trực tiếp với watch() và cảnh báo với alert(). - [Backtest & Phiên Tương Tự](https://vnstock-js-docs.vercel.app/md/key-features/advanced/backtest.md): Đo kết quả của một tín hiệu bằng event study, và tìm các phiên trong quá khứ có trạng thái giống hiện tại. - [Trình Duyệt & Proxy](https://vnstock-js-docs.vercel.app/md/key-features/advanced/proxy.md): Dùng vnstock-js trong client component qua proxy có sẵn. - [Lịch Giao Dịch - Calendar](https://vnstock-js-docs.vercel.app/md/key-features/advanced/calendar.md): Ngày giao dịch, ngày nghỉ lễ, phiên kế tiếp và phiên trước. - [Vàng, Tỷ Giá, Tin Tức](https://vnstock-js-docs.vercel.app/md/key-features/advanced/commodity.md): Giá vàng trong nước, tỷ giá Vietcombank, tin tài chính trong ngày. - [MCP Server](https://vnstock-js-docs.vercel.app/md/key-features/advanced/mcp.md): 27 công cụ dữ liệu chứng khoán Việt Nam cho Claude, Cursor, VS Code qua Model Context Protocol. - [Watchlist](https://vnstock-js-docs.vercel.app/md/key-features/advanced/watchlist.md): Danh sách mã theo dõi lưu ở ~/.vnstock-js, dùng qua CLI và MCP. - [Bar](https://vnstock-js-docs.vercel.app/md/data/ChartData.md): Một cây nến OHLCV. - [Quote](https://vnstock-js-docs.vercel.app/md/data/PriceBoardItem.md): Một dòng bảng giá. - [Tick](https://vnstock-js-docs.vercel.app/md/data/RealtimeQuote.md): Một lần khớp lệnh trực tiếp từ watch(). - [TopMover](https://vnstock-js-docs.vercel.app/md/data/TopStock.md): Mã tăng, giảm mạnh trong phiên. - [CompanyProfile](https://vnstock-js-docs.vercel.app/md/data/CompanyProfile.md): Hồ sơ công ty, cổ đông, ban lãnh đạo, sự kiện. - [ScreenRow](https://vnstock-js-docs.vercel.app/md/data/ScreenResult.md): Một dòng kết quả sàng lọc. - [GoldQuote & FxRate](https://vnstock-js-docs.vercel.app/md/data/ExchangeRate.md): Giá vàng và tỷ giá.