Описание API

Текущая ключевая ставка ЦБ

/api/key-rate/api/key-rate

Входные параметры

    Выходные параметры (JSON)

    • rate - Текущая ставка, % годовых
    • date - Актуально на (YYYY-MM-DD)

    Выгодно ли гасить кредит досрочно

    /api/early-repayment/report/api/early-repayment/report?rate=12.5&benchmarkRate=18.2&isMortgage=true&format=json

    Входные параметры

    • rate - Ставка по кредиту, % годовых (>= 0)
    • benchmarkRate - Ставка вклада/облигаций, % годовых (>= 0)
    • isMortgage - Признак ипотеки: true/false
    • format - Формат ответа: json, ui (по умолчанию json)

    Выходные параметры (JSON)

    • output.effectiveCreditRate - Эффективная ставка кредита
    • output.benchmarkForComparison - Ставка ориентира для сравнения
    • output.verdict.code - Код рекомендации

    Сколько инвестиций нужно, чтобы покрыть кредит

    /api/bonds-cover/report/api/bonds-cover/report?monthlyPayment=35000&monthsLeft=120&annualYieldPercent=18&remainingDebt=2500000&format=json

    Входные параметры

    • monthlyPayment - Ежемесячный платеж (> 0)
    • monthsLeft - Оставшиеся месяцы (> 0)
    • annualYieldPercent - Годовая доходность (> 0)
    • remainingDebt - Оценка остатка долга (опционально, >= 0)
    • format - json, ui

    Выходные параметры (JSON)

    • output.presentValueInvestment - Приведенная сумма вложений
    • output.couponOnlyNominal - Номинал для покрытия только купонами
    • output.debtComparison - Сравнение с остатком долга (если передан)

    Выгода от оплаты кредиткой

    /api/credit-card-benefit/report/api/credit-card-benefit/report?monthlySpending=100000&graceDays=50&savingsRatePercent=18&format=json

    Входные параметры

    • monthlySpending - Траты в месяц (>= 0)
    • graceDays - Грейс-период в днях (> 17)
    • savingsRatePercent - Ставка накопительного счета (>= 0)
    • format - json, ui

    Выходные параметры (JSON)

    • output.permanentAmount - Сумма, которая может лежать на счете постоянно
    • output.monthlyBenefit - Оценка выгоды в месяц
    • output.yearlyBenefit - Оценка выгоды в год

    Выгодно ли продавать квартиру в ипотеке

    /api/mortgage-sale/report/api/mortgage-sale/report?propertyValue=12500000&debt=5000000&monthlyPayment=65000&monthsLeft=180&rentPayment=70000&rentGrowthPercent=5&naosPercent=18&format=json

    Входные параметры

    • propertyValue - Текущая стоимость квартиры (> 0)
    • debt - Остаток долга (>= 0, <= propertyValue)
    • monthlyPayment - Ежемесячный платеж по ипотеке (>= 0)
    • monthsLeft - Оставшийся срок в месяцах (> 0)
    • rentPayment - Арендный платеж (опционально, >= 0)
    • rentGrowthPercent - Рост аренды в год (опционально, >= 0)
    • naosPercent - Ставка размещения средств (>= 0)
    • format - json, ui

    Выходные параметры (JSON)

    • output.sellFuture - Итог капитала при продаже
    • output.holdFuture - Итог капитала при удержании
    • output.verdict - Рекомендация: sell|hold|equal

    Сравнение ипотечных условий

    /api/mortgage-conditions-compare/report/api/mortgage-conditions-compare/report?propertyPrice=12000000&maxDownPayment=4000000&annualDepositRatePercent=18&termMonths=240&conditions=[{"id":"a","label":"Вариант 1","annualRatePercent":14,"minDownPaymentPercent":20,"gracePeriodMonths":0,"graceRatePercent":null},{"id":"b","label":"Вариант 2","annualRatePercent":13.5,"minDownPaymentPercent":25,"gracePeriodMonths":24,"graceRatePercent":8}]&format=json

    Входные параметры

    • propertyPrice - Стоимость недвижимости (> 0)
    • maxDownPayment - Максимальный первоначальный взнос (>= 0)
    • annualDepositRatePercent - Ставка размещения взноса (>= 0)
    • termMonths - Срок ипотеки в месяцах (> 0)
    • conditions - JSON-массив условий (минимум 2 варианта)
    • annualDiscountRatePercent - Ставка дисконтирования (опционально, >= 0)
    • format - json, ui

    Выходные параметры (JSON)

    • output.options - Массив итогов по вариантам
    • output.bestByNominal - Лучший вариант без дисконтирования
    • output.bestByDiscounted - Лучший вариант с учетом дисконтирования

    Аренда против покупки

    /api/rent-vs-buy/report/api/rent-vs-buy/report?rentCost=65000&apartmentPrice=12000000&mortgageRatePercent=14&downPayment=3000000&depositRatePercent=18&mortgageTermYears=20&format=json

    Входные параметры

    • rentCost - Ежемесячная аренда (>= 0)
    • apartmentPrice - Стоимость квартиры (> 0)
    • mortgageRatePercent - Ставка ипотеки (>= 0)
    • downPayment - Первоначальный взнос (>= 0, <= apartmentPrice)
    • depositRatePercent - Ставка депозита для сценария аренды (>= 0)
    • mortgageTermYears - Срок ипотеки в годах (> 0)
    • format - json, ui

    Выходные параметры (JSON)

    • output.finalRentCapital - Итоговый капитал в сценарии аренды
    • output.finalBuyCapital - Итоговый капитал в сценарии покупки
    • output.verdict - Рекомендация: buy|rent|equal

    Калькулятор сложных процентов

    /api/compound/report/api/compound/report?principal=100000&annualRatePercent=12&years=5&period=monthly&format=json

    Входные параметры

    • principal - Начальная сумма (> 0)
    • annualRatePercent - Годовая ставка (>= 0)
    • years - Срок в годах (> 0)
    • period - Капитализация: monthly|quarterly|yearly (опционально)
    • format - json, ui

    Выходные параметры (JSON)

    • output.amount - Итоговая сумма
    • output.interest - Начисленные проценты

    Дисконтирование

    /api/discounting/report/api/discounting/report?amount=100000&years=3&discountRatePercent=21&format=json

    Входные параметры

    • amount - Сумма сегодня (> 0)
    • years - Срок в годах (> 0)
    • discountRatePercent - Ставка дисконтирования (>= 0)
    • format - json, ui

    Выходные параметры (JSON)

    • output.discountedValue - Будущая стоимость после дисконтирования
    • output.discountLoss - Потеря стоимости

    Кредитный калькулятор

    /api/loan/report/api/loan/report?principal=3000000&annualRatePercent=12&termYears=20&paymentType=annuity&sampleLimit=6&format=json

    Входные параметры

    • principal - Сумма кредита (> 0)
    • annualRatePercent - Ставка в год (>= 0)
    • termYears - Срок в годах (> 0)
    • paymentType - Тип платежа: annuity|differentiated (опционально)
    • sampleLimit - Сколько строк графика вернуть (опционально)
    • format - json, ui

    Выходные параметры (JSON)

    • output.firstPayment - Первый платеж
    • output.lastPayment - Последний платеж
    • output.totalInterest - Суммарные проценты
    • output.scheduleSample - Первые строки графика платежей