Türkiye Loan Calculator: API and MCP
Türkiye Loan Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.
GET /api/v1/tools/finance.loan-payment.tr/mcp/finance
- Id
finance.loan-payment.tr- Version
- 1.0.0
- Access
- Free
- Tool page
- Türkiye Loan Calculator
- Schema
GET /api/v1/tools/finance.loan-payment.tr
Input
| Field | Type | Constraints | Default | Description |
|---|---|---|---|---|
principal (required) | number | > 0, ≤ 10,000,000,000 | Loan amount (TRY) | |
rate (required) | number | ≥ 0, ≤ 100 | Interest rate (%) · The contractual rate of the bank, without KKDF and BSMV. | |
rateUnit | string | monthly | yearly | monthly | Rate period |
months (required) | integer | ≥ 1, ≤ 480 | Term (months) | |
kkdf | number | ≥ 0, ≤ 100 | 15 | KKDF rate (%) · 15% on consumer and vehicle loans. Usually 0 on housing loans. |
bsmv | number | ≥ 0, ≤ 100 | 15 | BSMV rate (%) · 15% on consumer and vehicle loans. 0 on housing loans of buyers who own no other registered house. |
Output
| Field | Type | Description |
|---|---|---|
installment | number | Monthly installment (TRY) |
totalPayment | number | Total repayment (TRY) |
totalInterest | number | Total interest (TRY) |
totalKkdf | number | Total KKDF (TRY) |
totalBsmv | number | Total BSMV (TRY) |
monthlyRate | number | Monthly interest rate (%) |
grossRate | number | Monthly rate with taxes (%) |
schedule | array | Payment plan |
truncated | boolean | The payment plan was cut at 1,200 rows. |
Example request
{
"input": {
"principal": 100000,
"rate": 3,
"rateUnit": "monthly",
"months": 12,
"kkdf": 15,
"bsmv": 15
},
"locale": "en"
}Example answer
{
"output": {
"installment": 10593.48,
"totalPayment": 127121.8,
"totalInterest": 20862.94,
"totalKkdf": 3129.43,
"totalBsmv": 3129.43,
"monthlyRate": 3,
"grossRate": 3.8999999999999995,
"schedule": [
{
"month": 1,
"installment": 10593.48,
"principal": 6693.48,
"interest": 3000,
"kkdf": 450,
"bsmv": 450,
"balance": 93306.52
},
{
"month": 2,
"installment": 10593.48,
"principal": 6954.52,
"interest": 2799.2,
"kkdf": 419.88,
"bsmv": 419.88,
"balance": 86352
},
{
"month": 3,
"installment": 10593.48,
"principal": 7225.76,
"interest": 2590.56,
"kkdf": 388.58,
"bsmv": 388.58,
"balance": 79126.24
},
{
"month": 4,
"installment": 10593.48,
"principal": 7507.55,
"interest": 2373.79,
"kkdf": 356.07,
"bsmv": 356.07,
"balance": 71618.69
},
{
"month": 5,
"installment": 10593.48,
"principal": 7800.36,
"interest": 2148.56,
"kkdf": 322.28,
"bsmv": 322.28,
"balance": 63818.33
},
{
"month": 6,
"installment": 10593.48,
"principal": 8104.57,
"interest": 1914.55,
"kkdf": 287.18,
"bsmv": 287.18,
"balance": 55713.76
},
{
"month": 7,
"installment": 10593.48,
"principal": 8420.65,
"interest": 1671.41,
"kkdf": 250.71,
"bsmv": 250.71,
"balance": 47293.11
},
{
"month": 8,
"installment": 10593.48,
"principal": 8749.05,
"interest": 1418.79,
"kkdf": 212.82,
"bsmv": 212.82,
"balance": 38544.06
},
{
"month": 9,
"installment": 10593.48,
"principal": 9090.26,
"interest": 1156.32,
"kkdf": 173.45,
"bsmv": 173.45,
"balance": 29453.8
},
{
"month": 10,
"installment": 10593.48,
"principal": 9444.79,
"interest": 883.61,
"kkdf": 132.54,
"bsmv": 132.54,
"balance": 20009.01
},
{
"month": 11,
"installment": 10593.48,
"principal": 9813.13,
"interest": 600.27,
"kkdf": 90.04,
"bsmv": 90.04,
"balance": 10195.88
},
{
"month": 12,
"installment": 10593.52,
"principal": 10195.88,
"interest": 305.88,
"kkdf": 45.88,
"bsmv": 45.88,
"balance": 0
}
],
"truncated": false
},
"steps": [
{
"id": "grossRate",
"formula": "i = r × (1 + KKDF + BSMV)",
"substitution": "i = 3% × (1 + 15% + 15%)",
"value": 3.8999999999999995,
"unit": "%"
},
{
"id": "installment",
"formula": "A = P × i / (1 − (1 + i)^(−n))",
"substitution": "A = 100,000 × 3.9% / (1 − (1 + 3.9%)^(−12))",
"value": 10593.48
},
{
"id": "totalPayment",
"formula": "total payment = sum of the installments",
"substitution": "total payment = 10,593.48 × 11 + 10,593.52",
"value": 127121.8
}
],
"meta": {
"toolVersion": "1.0.0",
"locale": "en"
},
"citation": {
"url": "https://hesaplayici.com/en/finance/turkey-loan-calculator",
"title": "Türkiye Loan Calculator"
}
}