Tính lãi tiết kiệm API
Tính lãi tiền gửi có kỳ hạn như ngân hàng Việt Nam trả: cuối kỳ, hằng tháng hoặc trả trước, tái tục gốc hoặc gốc + lãi, và gửi góp hằng tháng.
API tính tiết kiệm cho biết khoản tiền gửi sinh lời bao nhiêu. Với tiền gửi có kỳ hạn, nhập số tiền, lãi suất năm và kỳ hạn (term_months); lãi có thể nhận cuối kỳ (interest=end), hằng tháng (monthly) hoặc trả trước (upfront, được chiết khấu theo P·r·t / (1 + r·t)). Với thời gian dài hơn (months), khoản gửi được tái tục: rollover=principal_interest nhập lãi vào gốc mỗi lần tái tục (lãi kép), principal thì rút lãi ra.
Với gửi góp (monthly_deposit), API cộng tiền gửi mỗi tháng và tính lãi kép theo tháng. Phản hồi có tổng tiền lãi, số dư cuối, tổng tiền nhận và lãi suất thực tế theo năm, cùng lịch theo kỳ hoặc theo tháng, để so sánh các gói gửi khác kỳ hạn và cách trả lãi.
Phép tính dùng quy ước theo tháng (lãi suất / 12 × số tháng). Ngân hàng tính theo số ngày thực tế (lãi suất × số ngày / 365) nên số tiền thật có thể lệch chút ít; rút trước hạn thường chỉ hưởng lãi không kỳ hạn. Lãi tiền gửi ngân hàng được miễn thuế thu nhập cá nhân tại Việt Nam.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
amount | body|query | number | không | Số tiền gửi ban đầu. | |
rate | body|query | number | có | Lãi suất năm (%). | |
term_months | body|query | number | không | 12 | Kỳ hạn gửi (0 = không kỳ hạn). |
months | body|query | number | không | Tổng thời gian (tháng), tính cả tái tục. | |
interest | body|query | string | không | end | end, monthly hoặc upfront. |
rollover | body|query | string | không | principal_interest | principal_interest, principal hoặc none. |
monthly_deposit | body|query | number | không | Số tiền gửi góp mỗi tháng. |
Ví dụ
curl "https://apibox.io.vn/v1/savings-calc?amount=100000000&rate=6&term_months=6&months=24" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/savings-calc?amount=100000000&rate=6&term_months=6&months=24', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/savings-calc?amount=100000000&rate=6&term_months=6&months=24",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/savings-calc?amount=100000000&rate=6&term_months=6&months=24');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"mode": "term_deposit",
"amount": 100000000,
"rate": 6,
"term_months": 6,
"months": 24,
"interest_payment": "end",
"rollover": "principal_interest",
"total_interest": 12550881,
"interest_paid_out": 0,
"final_balance": 112550881,
"total_received": 112550881,
"effective_annual_yield": 6.09,
"tax_on_interest": 0,
"periods": [
{
"period": 1,
"from_month": 1,
"to_month": 6,
"principal": 100000000,
"interest": 3000000,
"paid_out": 0,
"balance": 103000000
},
"…"
],
"note": "Simple monthly convention …"
}
Ứng dụng
- Công cụ tính lãi trên website ngân hàng, fintech
- So sánh gói gửi (lãi cuối kỳ, hằng tháng, trả trước)
- Lập kế hoạch tiết kiệm định kỳ
- Ứng dụng, bảng tính tài chính cá nhân
Hỏi đáp
Lãi cuối kỳ hay hằng tháng?
Lãi cuối kỳ thường có lãi suất cao hơn một chút và được nhập gốc khi tái tục; lãi hằng tháng cho dòng tiền đều nhưng lãi suất thấp hơn chút.
Lãi trả trước tính thế nào?
Vì nhận ngay từ đầu nên được chiết khấu: P × r × t / (1 + r × t), thấp hơn một chút so với lãi cuối kỳ cùng lãi suất.
Lãi tiết kiệm có bị đánh thuế không?
Không, lãi tiền gửi tại tổ chức tín dụng được miễn thuế thu nhập cá nhân tại Việt Nam.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.