🥇 Gold Price API

API giá vàng Việt Nam & thế giới — miễn phí, cập nhật mỗi 5 phút, không cần API key.

🆓 Miễn phí ⚡ 120 req/phút/IP 🔓 Không cần key 🥇 12+ loại vàng
Endpoints
GET /gold — Tất cả loại vàng GET /gold/{type_code} — Giá 1 loại vàng GET /gold/{type_code}?days=n — Lịch sử giá

🏷️ Các loại vàng hỗ trợ

XAUUSDVàng Thế Giới (XAU/USD)
SJL1L10SJC 9999
SJ9999Nhẫn SJC
DOHNLDOJI Hà Nội
DOHCMLDOJI HCM
DOJINHTVDOJI Nữ Trang
BTSJCBảo Tín SJC
BT9999NTTBảo Tín 9999
PQHNVMPNJ Hà Nội
PQHN24NTTPNJ 24K
VNGSJCVN Gold SJC
VIETTINMSJCViettin SJC
GET/gold

Lấy giá tất cả loại vàng hiện tại — SJC, DOJI, PNJ, Bảo Tín, XAU/USD. Trả về giá mua, giá bán, biến động giá trong ngày.

Tham số
✨Không cần tham số
Response
JSON
{
  "success": true,
  "timestamp": 1773743404,
  "time": "17:30",
  "date": "2026-03-17",
  "count": 12,
  "prices": {
    "SJL1L10": {
      "name": "SJC 9999",
      "buy": 180000000,
      "sell": 183000000,
      "change_buy": 400000,
      "change_sell": 400000,
      "currency": "VND"
    },
    "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
}
📋 Giải thích từng field:
• buy — Giá mua vào (VND/lượng hoặc USD/oz)
• sell — Giá bán ra
• change_buy — Biến động giá mua so với hôm trước
• change_sell — Biến động giá bán so với hôm trước
• currency — Đơ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)
Thử ngay
/api/v1/gold








GET/gold/{type_code}




Lấy giá 1 loại vàng cụ thể. Ví dụ: /gold/SJL1L10 để lấy giá SJC 9999.


Tham số




TênKiểuMô tả


type_codestringrequiredMã loại vàng (xem bảng ở trên)




Response


JSON


{
  "success": true,
  "timestamp": 1773743404,
  "type": "SJL1L10",
  "name": "SJC 9999",
  "buy": 180000000,
  "sell": 183000000,
  "change_buy": 400000,
  "change_sell": 400000,
  "cached": false
}


Thử ngay


/api/v1/gold/SJL1L10








GET/gold/{type_code}?days={n}




Lấ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á.


Tham số




TênKiểuMô tả


type_codestringrequiredMã loại vàng


daysnumberoptional1–30. Số ngày lịch sử




Thử ngay


/api/v1/gold/SJL1L10?days=7








💻 Code Examples


JavaScript


// 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.SJL1L10;
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}`);



cURL


# Tất cả giá vàng
curl "https://keoquy.com/api/v1/gold"

# Giá SJC 9999
curl "https://keoquy.com/api/v1/gold/SJL1L10"

# Lịch sử giá SJC 7 ngày
curl "https://keoquy.com/api/v1/gold/SJL1L10?days=7"

# Giá vàng thế giới
curl "https://keoquy.com/api/v1/gold/XAUUSD"



Python


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/SJL1L10?days=7").json()








📝 Ghi chú







Đơn vị giá


• 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







Cache & cập nhật


• Dữ liệu được cache 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 & nguồn dữ liệu


• Rate limit: 120 requests/phút per IP

• Nguồn dữ liệu: vang.today

• Miễn phí, không cần API key, không cần đăng ký













⚠️ Error Response


JSON


{ "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 — Upstream lỗi (thử lại sau vài giây)