Giá vàng trong nước, tỷ giá Vietcombank, tin tài chính trong ngày.
import { vn } from "vnstock-js";
const gold = await vn.gold(); // BTMC, lỗi thì chuyển GiaVang.net
const sjc = gold.items.find((g) => /SJC/.test(g.name));
console.log(gold.source, sjc?.buy, sjc?.sell); // đồng/lượng
await vn.gold({ source: "giavangnet" }); // chọn nguồn: "auto" | "btmc" | "giavangnet"
{
"source": "btmc",
"unit": "VND/luong",
"items": [
{ "name": "VÀNG MIẾNG SJC (Vàng SJC)", "code": "", "karat": "24k", "buy": 138600000, "sell": 142600000,
"buyChange": null, "sellChange": null, "updatedAt": "2026-10-20T12:19:00+07:00" }
]
}
buy, sell là null khi nguồn không niêm yết giá đó.const rates = await vn.fx(); // hôm nay
const usd = rates.find((r) => r.currencyCode === "USD");
// { currencyCode: "USD", currencyName: "US DOLLAR", buyCash: 25650, buyTransfer: 25680, sell: 26060 }
await vn.fx({ date: "2026-10-15" });
Tỷ giá Vietcombank, đồng trên một đơn vị ngoại tệ; null khi ngân hàng không niêm yết.
const today = await vn.news();
const banks = await vn.news({ query: "ngân hàng" });
const one = await vn.news({ date: "2026-10-14", source: "Vietstock" });
Tin tài chính tổng hợp mỗi ngày từ news-crawler. query lọc theo tiêu đề và tóm tắt, source lọc theo nguồn, không phân biệt hoa thường. Mỗi tin có id, source, title, summary, link, image, publishedAt.
Tin riêng của một công ty: vn.stock("FPT").news().