vnstock-js

vnstock-js

Tài LiệuDùng Với AIVí DụBài ViếtDemo
k

© Copyright 2026

Giới Thiệu
Cài Đặt
Hướng Dẫn Sử Dụng Nhanh
Quy Ước & Đơn Vịv2.0
Dùng Với AIv2.0
Kiến Trúc
Danh Sách Hàm
Nâng Cấp Từ v1v2.0
CLI
Lịch Sử Phiên Bản
Câu Hỏi Thường Gặp
Cơ Bản
Bảng Giá - Prices
Lịch Sử Giá - History
Danh Mục Mã - Symbols
Tìm Kiếm - Search
Tài Chính - Financials
Thị Trường - Marketv1.5
Sàng Lọc - Screening
Chỉ Báo & Pattern
AI Contextv1.4
Danh Mục Đầu Tưv2.0
Theo Dõi & Cảnh Báov2.0
Backtest & Phiên Tương Tựv2.0
Trình Duyệt & Proxyv2.0
Lịch Giao Dịch - Calendar
Vàng, Tỷ Giá, Tin Tức
MCP Serverv1.4
Watchlistv1.4
Bar
Quote
Tick
TopMover
CompanyProfile
ScreenRow
GoldQuote & FxRate
  1. Tài Liệu
  2. Getting Started
  3. Introduction

Giới Thiệu

Tổng quan về vnstock-js, thư viện dữ liệu chứng khoán Việt Nam cho JavaScript và TypeScript.

Xem .md

vnstock-js là thư viện mã nguồn mở lấy dữ liệu chứng khoán Việt Nam cho JavaScript và TypeScript. Chạy trên Node, Bun, Deno, Cloudflare Workers, Vercel Edge, và trên trình duyệt qua proxy đóng gói sẵn.

import { vn } from "vnstock-js";

const fpt = vn.stock("FPT");
await fpt.price();        // { price: 127000, changePct: 0.95, ... }
await fpt.history("6mo"); // nến ngày, giá tính bằng đồng
await vn.market();        // VN-Index, thanh khoản, độ rộng, khối ngoại

👉 vnstock-js trên npm · GitHub · Trang demo vnstock-js-site

Điểm chính của bản 2.0

  • Một API gọn: vn.stock('FPT'), vn.index('VNINDEX'), vn.market(), vn.screen()... Không cần khóa API, không cần hàm khởi tạo.
  • Tiền luôn tính bằng đồng, chỉ số tính bằng điểm, tỷ số là phân số. Xem Quy ước & đơn vị.
  • Chạy mọi nơi: core dùng fetch có sẵn, không đụng ổ đĩa; trình duyệt đi qua proxy vnstock-js/proxy.
  • Dành cho AI agent: JSDoc kèm ví dụ cho mọi API, AGENTS.md trong package, MCP server 27 công cụ.

Tính năng

Tính năngMô tả
Bảng giá, lịch sử giáGiá hiện tại, nến từ 1 phút tới 1 tháng, gộp khung ngay trong thư viện
Thông tin công ty, tài chínhHồ sơ, cổ đông, ban lãnh đạo, sự kiện, cổ tức, báo cáo tài chính
Thị trườngTổng quan, độ 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ọcLọc theo P/E, ROE, vốn hoá... bằng where và sort
Chỉ báo & patternSMA, EMA, RSI, MACD, hỗ trợ/kháng cự, mẫu nến, Turtle, sức khoẻ thị trường
Danh mục đầu tưĐịnh giá theo giá hiện tại, nhóm theo môi giới và ngành
Theo dõi & cảnh báowatch() qua WebSocket hoặc poll, alert() khi giá vượt đỉnh
BacktestEvent study với chốt lời, cắt lỗ, số phiên giữ; tìm phiên tương tự
Vàng, tỷ giá, tin tứcBTMC, GiaVang.net, Vietcombank, tin tài chính trong ngày
MCP & CLIDùng trong Claude, Cursor, VS Code; tra cứu nhanh trên terminal

Đang dùng bản 1.x? Đọc Nâng cấp từ v1.

Nhà phát triển

Được phát triển bởi github.com/ttqteo. Lấy cảm hứng từ thinh-vu/vnstock cho Python.

Note:

Dữ liệu chỉ phục vụ tham khảo, không phải khuyến nghị đầu tư.

NextCài Đặt

Nội Dung

Điểm chính của bản 2.0Tính năngNhà phát triển