Fuel Price API

API giá xăng dầu bán lẻ Việt Nam — miễn phí, nguồn PVOIL, không cần API key.

🆓 Miễn phí ⚡ 120 req/phút/IP 🔓 Không cần key
Endpoints
GET /fuel — Giá xăng dầu hiện tại GET /fuel/history — Lịch sử các kỳ điều chỉnh
GET/fuel

Lấy giá xăng dầu bán lẻ hiện tại — RON 95, E5 RON 92, DO, E10. Bao gồm giá và mức thay đổi so với kỳ trước.

Tham số
Không cần tham số
Response
JSON
{
  "success": true,
  "source": "PVOIL",
  "effective_time": "22:00",
  "effective_date": "12/03/2026",
  "updated_at": "2026-03-19 15:25",
  "prices": [
    {
      "name": "Xăng RON 95-III",
      "price": 25570,
      "change": 330,
      "unit": "đồng/lít"
    },
    {
      "name": "Xăng E5 RON 92-II",
      "price": 22500,
      "change": -450,
      "unit": "đồng/lít"
    },
    // ... các loại xăng dầu khác
  ],
  "cached": false
}
📋 Giải thích:
price — Giá bán lẻ (đồng/lít)
change — Tăng/giảm so với kỳ trước (dương = tăng, âm = giảm)
effective_date — Ngày áp dụng giá hiện tại
cached — true nếu dữ liệu từ cache (cache 10 phút)
Thử ngay
/api/v1/fuel
GET/fuel/history

Lấy lịch sử giá xăng dầu các kỳ điều chỉnh gần nhất. Mặc định 10 kỳ, tối đa 30 kỳ.

Tham số
TênKiểuMô tả
limitnumberoptional1–30. Số kỳ điều chỉnh muốn lấy (mặc định: 10)
Thử ngay
/api/v1/fuel/history?limit=3

💻 Code Examples

JavaScript
// Lấy giá xăng dầu hiện tại
const res = await fetch('https://keoquy.com/api/v1/fuel');
const data = await res.json();

data.prices.forEach(item => {
  const arrow = item.change > 0 ? '▲' : item.change < 0 ? '▼' : '—';
  console.log(`${item.name}: ${item.price.toLocaleString()}đ ${arrow}${Math.abs(item.change)}`);
});
cURL
# Giá xăng dầu hiện tại
curl "https://keoquy.com/api/v1/fuel"

# Lịch sử 5 kỳ điều chỉnh gần nhất
curl "https://keoquy.com/api/v1/fuel/history?limit=5"
Python
import requests

data = requests.get("https://keoquy.com/api/v1/fuel").json()

for item in data["prices"]:
    arrow = "▲" if item["change"] > 0 else "▼" if item["change"] < 0 else "—"
    print(f"{item['name']}: {item['price']:,}đ {arrow}{abs(item['change']):,}")

📝 Ghi chú

Nguồn dữ liệu & cập nhật
• Nguồn: PVOIL (Tổng Công ty Dầu Việt Nam)
• Cache: 10 phút cho giá hiện tại, 1 giờ cho lịch sử
• Giá được cập nhật theo kỳ điều chỉnh của Bộ Công Thương (thường mỗi 7 ngày)