📈 vnstock-js

A lightweight NPM package for fetching Vietnam stock market data from VCI.

Quick Start

1. Install the package

npm install vnstock-js@latest

2. Quick Usage

2.1. Simple (recommended)

import { stock, commodity } from 'vnstock-js';

// Ticker history data
const history = await stock.quote({ticker: 'VCI', start: '2025-01-01'});

// Ticker price board
const priceBoard = await stock.priceBoard({ticker: 'VCI'});

// Top gainers in day
const priceBoard = await stock.topGainers();

// Top losers in day
const priceBoard = await stock.topLosers();


// Gold Price from SJC
const goldPrices = await commodity.gold.priceSJC();

2.2. Advanced

import vnstock from 'vnstock-js';

// Access everything directly
const prices = await vnstock.stock.quote.history({
  symbols: ['VCI'],
  start: '2025-01-01',
  timeFrame: '1D'
});

Documentation

vnstock-js-docs.vercel.app

Note

This npm package inspired by thinh-vu/vnstock

License

Apache 2.0 License Ⓒ ttqteo 2025