API Documentation - Giá Vàng

Endpoints

GET /api/prices

Lấy giá vàng hiện tại của tất cả loại vàng

GET /api/prices?type={code}

Lấy giá vàng của một loại cụ thể

GET /api/prices?type={code}&days={n}

Lấy lịch sử giá n ngày

Tham số

Tham số	Kiểu	Mô tả
`type`	string	Mã loại vàng (XAUUSD, SJL1L10, SJ9999...)
`days`	integer	Số ngày lịch sử (1-30)
`action`	string	"current" để lấy giá hiện tại, "summary" để lấy tóm tắt

Phản hồi mẫu

{
  "success": true,
  "current_time": 1732456789,
  "data": [
    {
      "type_code": "SJL1L10",
      "buy": 85500000,
      "sell": 88000000,
      "change_buy": 100000,
      "change_sell": 100000,
      "update_time": 1732456789
    }
  ]
}

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

XAUUSD

Vàng Thế Giới (XAU/USD)

SJL1L10

SJC 9999

SJ9999

Nhẫn SJC

DOHNL

DOJI Hà Nội

DOHCML

DOJI HCM

DOJINHTV

DOJI Nữ Trang

BTSJC

Bảo Tín SJC

BT9999NTT

Bảo Tín 9999

PQHNVM

PNJ Hà Nội

PQHN24NTT

PNJ 24K

VNGSJC

VN Gold SJC

VIETTINMSJC

Viettin SJC

Lưu ý

✓ API hoàn toàn miễn phí, không cần API key
✓ Dữ liệu được cập nhật mỗi 5 phút
✓ Giá vàng trong nước tính bằng VND/lượng
✓ Giá vàng thế giới (XAUUSD) tính bằng USD/oz
✓ CORS được bật, có thể gọi từ browser

Ví dụ sử dụng

JavaScript (fetch)

fetch('/api/prices')
  .then(res => res.json())
  .then(data => console.log(data));

cURL

curl "https://giavang.now/api/prices?type=SJL1L10"

PHP

$data = json_decode(file_get_contents('https://giavang.now/api/prices'));