API giá vàng aggregator đa nguồn — Việt Nam & thế giới, miễn phí, cập nhật mỗi 5 phút, không cần API key.
XAUUSDVàng thế giới USD/ozSJC_SJCSJC miếng toàn quốcSJC_SJC_HCMSJC TP.HCMDOJIDOJI toàn quốcPNJ_HANOIPNJ Hà NộiPNJPNJ toàn quốcBTMC_HANOIBTMC Hà NộiBTMC_SJC_HANOIBTMC SJC Hà NộiBAO_TIN_*Bảo TínPHUQUY_HANOIPhú Quý Hà NộiMI_HONG_*Mi HồngLấy giá tất cả loại vàng hiện tại từ nhiều nguồn — SJC, DOJI, PNJ, BTMC, Bảo Tín, Phú Quý, XAU/USD. Trả về giá mua/bán, vùng, nguồn và độ tin cậy.
{
"success": true,
"timestamp": 1773743404,
"time": "17:30",
"date": "2026-03-17",
"count": 12,
"prices": {
"SJC_SJC": {
"name": "SJC",
"buy": 180000000,
"sell": 183000000,
"change_buy": 400000,
"change_sell": 400000,
"currency": "VND",
"brand": "SJC",
"region": "Toàn quốc",
"sources": ["24h", "simplize"],
"confidence": 95
},
"XAUUSD": {
"name": "Vàng Thế Giới (XAU/USD)",
"buy": 2985.50,
"sell": 2986.00,
"change_buy": 12.50,
"change_sell": 12.50,
"currency": "USD"
}
// ... thêm nhiều loại vàng khác
},
"cached": false
}buy — Giá mua vào (VND/lượng hoặc USD/oz)sell — Giá bán rachange_buy — Biến động giá mua so với hôm trướcchange_sell — Biến động giá bán so với hôm trước nếu nguồn cóbrand/product/region — Thương hiệu, loại vàng, khu vực ưu tiên Hà Nộisources/source_count/confidence — Nguồn dùng để tổng hợp và điểm tin cậycurrency — Đơn vị tiền tệ (VND hoặc USD)cached — true nếu dữ liệu từ cache server (cập nhật mỗi 5 phút)
/api/v1/goldLấy giá 1 loại vàng cụ thể. Ví dụ: /gold/SJC_SJC để lấy giá SJC.
| Tên | Kiểu | Mô tả | |
|---|---|---|---|
| type_code | string | required | Mã loại vàng (xem bảng ở trên) |
{
"success": true,
"timestamp": 1773743404,
"type": "SJC_SJC",
"name": "SJC",
"buy": 180000000,
"sell": 183000000,
"change_buy": 400000,
"change_sell": 400000,
"cached": false
}/api/v1/gold/SJC_SJCLấy lịch sử giá vàng trong n ngày gần nhất (1–30 ngày). Hữu ích để vẽ biểu đồ xu hướng giá.
| Tên | Kiểu | Mô tả | |
|---|---|---|---|
| type_code | string | required | Mã loại vàng |
| days | number | optional | 1–30. Số ngày lịch sử |
/api/v1/gold/SJC_SJC?days=7// Lấy giá tất cả loại vàng const res = await fetch('https://keoquy.com/api/v1/gold'); const data = await res.json(); // In giá SJC 9999 const sjc = data.prices.SJC_SJC; console.log(`SJC Mua: ${sjc.buy.toLocaleString()}đ — Bán: ${sjc.sell.toLocaleString()}đ`); // Lấy giá 1 loại cụ thể const xau = await fetch('https://keoquy.com/api/v1/gold/XAUUSD').then(r => r.json()); console.log(`XAU/USD: $${xau.buy}`);
# Tất cả giá vàng curl "https://keoquy.com/api/v1/gold" # Giá SJC 9999 curl "https://keoquy.com/api/v1/gold/SJC_SJC" # Lịch sử giá SJC 7 ngày curl "https://keoquy.com/api/v1/gold/SJC_SJC?days=7" # Giá vàng thế giới curl "https://keoquy.com/api/v1/gold/XAUUSD"
import requests # pip install requests # Lấy tất cả giá vàng data = requests.get("https://keoquy.com/api/v1/gold").json() # In giá mua/bán từng loại for code, info in data["prices"].items(): buy = f"{info['buy']:,.0f}" if info['currency'] == 'VND' else f"{info['buy']}" print(f"{info['name']}: Mua {buy} — Bán {info['sell']:,.0f}") # Lịch sử giá SJC 7 ngày history = requests.get("https://keoquy.com/api/v1/gold/SJC_SJC?days=7").json()
• Giá vàng Việt Nam (VND): tính bằng đồng/lượng. VD: 180.000.000 = 180 triệu/lượng
• Giá vàng thế giới (XAUUSD): tính bằng USD/troy ounce
• Dữ liệu được cache 5 phút, capture 5 phút phía server để tối ưu performance
• Field cached: true cho biết dữ liệu từ cache
• Field stale: true nếu upstream lỗi và đang dùng dữ liệu cũ
• Rate limit: 120 requests/phút per IP
• Nguồn dữ liệu: DOJI official, BTMC official, Bảo Tín Mạnh Hải official, WebGia tổng hợp/SJC/PNJ, 24h, Simplize, BaoMoi/BTMC; XAU/USD ưu tiên Simplize/WebGia, Coingecko chỉ fallback
• Lịch sử lưu 5 năm trong gold_price_ticks, chỉ ghi thêm khi giá thay đổi hoặc sang ngày mới
• Miễn phí, không cần API key, không cần đăng ký
{ "success": false, "error": "Không thể lấy dữ liệu giá vàng" }
// 404 — Mã loại vàng không hợp lệ
// 429 — Rate limit exceeded (chờ 1 phút)
// 502 — Không đủ nguồn dữ liệu (thử lại sau vài giây)