A Vietnamese market-tracking CLI tool that displays real-time prices for gasoline, gold (SJC), cryptocurrencies (BTC/ETH), and Vietnam ETFs — all from your terminal.

• Node.js v18 or higher
• npm v8 or higher or Yarn v1.22 or higher
• A Binance account with API key & secret

# Clone the repository
git clone https://github.com/your-username/market-watch-vn.git
cd market-watch-vn

npm

npm install
npm run dev

yarn

yarn install
yarn dev

This lets you run market-watch from anywhere on your machine.

# Clone and enter the repo
git clone https://github.com/your-username/market-watch-vn.git
cd market-watch-vn

npm

npm install
npm run build
npm link

yarn

yarn install
yarn build
yarn link

After linking, the market-watch command becomes available in any terminal session:

market-watch

To unlink later:

npm

npm unlink -g market-watch

yarn

yarn unlink market-watch

This project requires environment variables to connect to external APIs. Two loading strategies are supported:

Create a .env file in the project root:

PVOIL_ENDPOINT=https://...
BINANCE_APIKEY=your_binance_api_key
BINANCE_SECRETKEY=your_binance_secret_key

When running market-watch as a global command, the local .env is not in scope. Instead, create a config file in your home directory:

Windows: C:\Users\<YourName>\.market-watch.env macOS / Linux: ~/.market-watch.env

PVOIL_ENDPOINT=https://...
BINANCE_APIKEY=your_binance_api_key
BINANCE_SECRETKEY=your_binance_secret_key

The CLI automatically falls back to ~/.market-watch.env if no local .env is found.

market-watch

An interactive prompt will appear. Use arrow keys to navigate, Space to select categories, and Enter to confirm.

Available categories:

• Tất cả — fetch all data at once
• Giá xăng hôm nay — current gasoline prices
• Giá vàng hôm nay — SJC gold prices (buy/sell)
• Bitcoin — BTC/USDT price from Binance
• Ethereum — ETH/USDT price from Binance
• ETF VN30 — E1VFVN30 reference price
• ETF VN Diamond — FUEVFVND reference price

After viewing results, you can choose to check more categories or exit.

src/
├── index.ts              # CLI entry point & interactive prompt
├── constants/
│   └── env.ts            # Environment variable loading
├── interfaces/
│   └── index.ts          # TypeScript interfaces
├── services/
│   ├── binance.ts        # Binance crypto price fetching
│   ├── pvoil.ts          # PV Oil gasoline price scraping
│   └── vnstock.ts        # Gold & ETF prices via vnstock-js
└── utils/
    └── index.ts          # Number formatting utilities

MIT