vnstock-js
Thư viện JavaScript nhanh nhất để truy cập dữ liệu chứng khoán Việt Nam. Nhẹ, type-safe, sẵn sàng cho production.
npm install vnstock-jsREALTIME
WebSocket Streaming
vn.watch() nhận giá khớp qua WebSocket, có chế độ poll cho serverless và trình duyệt.
TECHNICALS
Chỉ báo kỹ thuật
SMA, EMA, RSI, MACD, vùng hỗ trợ/kháng cự, mẫu nến, Turtle trong vnstock-js/indicators.
SCREENING
Sàng lọc cổ phiếu
Lọc theo P/E, ROE, vốn hoá bằng where và sort, theo nhóm VN30 hoặc theo sàn.
TYPESCRIPT
Type-safe
Type và JSDoc kèm ví dụ cho mọi API, tiền luôn tính bằng đồng.
Built for Speed
3 dòng code.
Không API key. Không đăng ký.
Gọi trực tiếp từ server hoặc script. Dữ liệu được chuẩn hóa, có type sẵn, sẵn sàng render.
index.ts
import { vn } from "vnstock-js";
import { sma } from "vnstock-js/indicators";
// Giá hiện tại và nến ngày 6 tháng của FPT, tiền tính bằng đồng
const quote = await vn.stock("FPT").price();
const bars = await vn.stock("FPT").history("6mo");
// SMA 20 phiên
const sma20 = sma(bars, { period: 20 });
AI Agent
Hỏi bằng tiếng Việt.
Trả lời bằng dữ liệu thật.
Cắm vnstock-js vào Claude Desktop, Cursor hay VS Code qua MCP. Agent tự chọn trong 27 công cụ: bảng giá, chỉ báo, sàng lọc, khối ngoại, backtest.
"vnstock": {
"command": "npx",
"args": ["-y", "vnstock-js", "mcp"]
}
Dùng vnstock-js với AIThử hỏi:
AI agent · vnstock-js MCP
Thị trường hôm nay ra sao?
Mô phỏng: cài MCP trên máy rồi hỏi Claude Desktop, Cursor hay VS Code, agent sẽ gọi các công cụ này. Số liệu là thật, lấy bằng vnstock-js và làm mới mỗi giờ; câu trả lời là mẫu dựng sẵn.
Architecture
Một client.
Chạy ở mọi nơi.
Mọi lời gọi đi qua client, source rồi transport. Chỉ báo và backtest là hàm thuần, không gọi mạng. Trình duyệt đi qua proxy có sẵn trong thư viện.
Ứng dụng của bạn
Node · Bun · Deno · Workers · trình duyệt
Client
vn · createClient({ proxy, storage, ... })
stock() · index() · market() · screen() · portfolio() · watch()
Dữ liệu
Source VCI
đổi dữ liệu VCI sang Bar, Quote (đồng)
Transport
fetch · retry · rate limit · proxy
chỉ trên trình duyệt
vnstock-js/proxy
chuyển tiếp theo danh sách đường dẫn cố định
VietCap
bảng giá · nến · công ty · tài chính
Thời gian thực
Realtime
watch(): một WebSocket chung, hoặc poll
SSI WebSocket
giá khớp trực tiếp
Bộ nhớ đệm
Storage
memoryStorage · fileStorage
tải lười, cache
Dữ liệu trên GitHub
mã · lịch nghỉ · tỷ số · khối ngoại
Tính toán
Compute & indicators
hàm thuần trên Bar[], không gọi mạng
Sẵn sàng bắt đầu?
Đọc tài liệu, xem ví dụ mẫu với dữ liệu thật, hoặc bắt tay vào code ngay.