🏦 Savings Rate API

Lãi suất gửi tiết kiệm VND mirror đúng danh sách bank đang hiển thị ở /thitruong#interest — Miễn phí, cached 15 phút, không cần API key.

🆓 Miễn phí ⚡ 120 req/phút/IP 🔓 Không cần key 🏦 28 bank
Endpoints
GET /savings-rate — Tất cả lãi suất

🏦 Ngân hàng hỗ trợ

MB BankMBB — CAFEF
MSBMSB — CAFEF
ABBANKABB — CAFEF
ACBACB — CAFEF
AgribankAGB — CAFEF
Bac A BankBAB — CAFEF
BAOVIET BankBVB — CAFEF
BIDVBID — CAFEF
KienlongbankKLB — CAFEF
LPBankLPB — CAFEF
Nam A BankNAB — CAFEF
OCBOCB — CAFEF
PGBankPGB — CAFEF
SeABankSSB — CAFEF
TPBankTPB — CAFEF
VIBVIB — CAFEF
VietcombankVCB — CAFEF
VietinBankCTG — CAFEF
VPBankVPB — CAFEF
SHBSHB — CAFEF
HDBankHDB — CAFEF
NCBNCB — CAFEF
VietABankVAB — CAFEF
BVBankBVB — CAFEF
SacombankSTB — CAFEF
EximbankEIB — CAFEF
VietbankVTB — CAFEF
Shinhan BankSHINHAN — CAFEF
GET/savings-rate

Lấy lãi suất gửi tiết kiệm VND từ cùng dataset với /thitruong#interest. API mirror đủ 28 bank đang hiển thị ở bảng lãi suất. Lọc theo ngân hàng hoặc kỳ hạn. Cached 15 phút.

Tham số
TênKiểuMô tả
bankstringoptionalLọc theo ngân hàng: hỗ trợ toàn bộ bank trong dataset.
termstringoptionalLọc theo kỳ hạn: 0 (không kỳ hạn) · 1 · 3 · 6 · 12 · 24
forcenumberoptionalBypass cache: 1
Response
JSON
{
  "success": true,
  "updated_at": "2026-05-09T18:10:00+07:00",
  "updated_date": "09/05/2026",
  "note": "Lãi suất tiết kiệm VND tham khảo, lấy từ nguồn động cùng dữ liệu với /thitruong#interest.",
  "items": [
    { "term": "Không kỳ hạn", "term_key": "0T", "rate": 0.1, "bank": "Vietcombank", "symbol": "VCB", "unit": "%/năm" },
    { "term": "1 tháng", "term_key": "1T", "rate": 1.6, "bank": "Vietcombank", "symbol": "VCB", "unit": "%/năm" },
    { "term": "6 tháng", "term_key": "6T", "rate": 2.9, "bank": "Vietcombank", "symbol": "VCB", "unit": "%/năm" },
    { "term": "12 tháng", "term_key": "12T", "rate": 4.7, "bank": "Vietcombank", "symbol": "VCB", "unit": "%/năm" }
    // ... đủ các bank đang hiện ở /thitruong#interest
  ],
  "sources": [{ "bank": "Vietcombank", "ok": true }, ... (toàn bộ bank)],
  "bank_count": 28,
  "total_items": 198,
  "cache_policy": "dynamic_15min"
}
📋 Giải thích từng field:
• term — Kỳ hạn gửi: "Không kỳ hạn", "1 tháng", "3 tháng", "6 tháng", "9 tháng", "12 tháng", "18 tháng", "24 tháng"
• term_key — Mã kỳ hạn: "0T", "1T", "3T", "6T", "9T", "12T", "18T", "24T"
• rate — Lãi suất %/năm
• bank — Tên ngân hàng, khớp với bảng /thitruong#interest
• symbol — Mã ngân hàng nếu nguồn có cung cấp
• unit — Luôn là "%/năm"
• sources — Trạng thái từng ngân hàng
• source / source_url — Nguồn dữ liệu đang được chọn
• bank_count — Số bank đang có dữ liệu, hiện mirror /thitruong#interest
• cache_policy — "dynamic_15min" = dữ liệu động, cached 15 phút
Thử ngay
/api/v1/savings-rate








💻 Code Examples


JavaScript


// Tất cả lãi suất
const res = await fetch('https://keoquy.com/api/v1/savings-rate');
const { data } = await res.json();

// Tìm lãi suất Vietcombank 12 tháng
const vcb12 = data.items.find(x => x.bank === 'Vietcombank' && x.term === '12 tháng');
console.log(`VCB 12 tháng: ${vcb12.rate}%/năm`);



cURL


# Tất cả lãi suất
curl "https://keoquy.com/api/v1/savings-rate"

# Lọc Vietcombank
curl "https://keoquy.com/api/v1/savings-rate?bank=Vietcombank"



Python


import requests

data = requests.get("https://keoquy.com/api/v1/savings-rate").json()["data"]

# So sánh 12 tháng giữa các ngân hàng
for item in data["items"]:
    if item["term"] == "12 tháng":
        print(f"{item['bank']}: {item['rate']}%/năm")








📝 Ghi chú






🏦 Dữ liệu lãi suất cơ sở


Dữ liệu lấy từ cùng nguồn động với bảng lãi suất tại /thitruong#interest. Danh sách bank trong API được mirror từ bảng này để không thiếu bank.






⚡ Cache & cập nhật


Dữ liệu cached 15 phút. Dùng ?force=1 để bypass cache.






⚠️ Lưu ý quan trọng


Dữ liệu là tham khảo theo nguồn công khai. Rate thực tế khi gửi có thể khác theo hình thức gửi, số tiền, ưu đãi và thời điểm cập nhật của ngân hàng.












⚠️ Error Response


JSON


{ "success": false, "error": "..." }
// 429 — Rate limit exceeded (chờ 1 phút)