ForHosting KIT · 金融・お金

手数料込みローンAPR計算

融資手数料の本当のコストが分かります。200,000を年6.5パーセント・360か月で借り、手数料4,000を残高に組み込むと、実質年率は6.5パーセントではなく6.6914パーセントです。受け取る現金に対する利率で比べられ、ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

ローン金額: 200,000
年率 (%): 6.5
期間 (か月): 360
手数料: 4,000

結果

額面金額: 204,000
月々の支払額: 1,289.4188
支払合計: 464,190.7565
利息合計: 260,190.7565

表示金利は残高に繰り入れられる事務手数料を見落とします。借り手が一定の手元資金を必要とし、貸し手がその金額の上に諸費用を融資する場合、月々の返済額はより大きな名目元本に基づいて計算されますが、借り手が実際に使えるのは純受取額だけです。本ローンAPR（手数料込み）計算は、必要な純額・表示年利・月数・融資手数料合計を受け取り、名目元本に対する均等返済額と、標準的な定額返済モデルでその返済流を純受取額に等しくする実質年率を返します。

融資手数料が実質年率に与える影響

通常の固定金利・元利均等ローンでは、表示年利を十二で割った一定の月利で、一定回数の月にわたって名目元本を完済するよう月々の返済額が決まります。初期手数料をローンに組み込むと、名目元本は借り手が必要とする現金とその手数料の合計になります。利息と元本返済はより大きな名目元本に対して進むため、同じ純受取額の手数料なしローンより返済額は上がります。

規制的な意味での実質年率は表示クーポンではなく、返済流の現在価値を借り手が実質的に受け取る額に一致させる、月次数理金利の十二倍として表される一定の年率です。返済年金は名目元本で寸法が決まり、現在価値の目標は純受取額だけなので、正の融資手数料は必ず実質年率を表示金利より押し上げます。手数料が零のとき、実質年率は（丸めを除き）表示金利に一致します。

表示金利が零でも手数料が正なら、返済は依然として名目を期間で割った額となり、ソルバーは手数料だけによる負担を反映した正の実質年率を求めます。本機能はそのモデルをそのまま実装します。名目＝ローン額＋手数料、標準償却式による返済、純受取額に一致する月利を決定的な二分法で求め、その月利に百を掛けて十二倍した年率として年間化します。

手数料調整ローンAPR計算が役立つ場面

住宅ローンや個人ローンの比較サイトは、事務手数料が残高に繰り入れられるとき、クーポンだけでなく真のコストで見積を並べるために手数料込みAPR計算を使います。ブローカーやローン担当者は、デスクトップの償却表を開かずに手数料行を変えながら即時再計算できる決定的な数値が必要です。

家計教育や LMS は、同じ金利・期間でもポイントや事務手数料を融資するとなぜ差が出るかを問う課題のためのオラクルを必要とします。検証失敗は残高を消費しません。

活用例

融資手数料込みのローン見積比較

クーポンと事務手数料が異なる二つの見積を、各手数料パッケージを名目元本に組み込んだ後の実質年率で並べ替えます。

ブローカー・アドバイザーのライブ試算

お客様が金額・期間・金利・融資する諸費用を変えた瞬間に、月々返済と手数料調整APRを再計算します。

よくある質問

すべての法定APR開示と一致しますか？

定額返済・手数料融資の明確な推定を実装しています。現地規則は前払い金融費用・日数計算・端数期間を別様に定義し得ます。結果は比較ツールとして扱い、唯一の法的開示としないでください。

実質年率が表示金利より高くなるのはなぜですか？

返済額は手数料を含む大きい金額で計算されるのに、実際に受け取るのは差し引いた金額だけだからです。同じ現金に多く払うことになるため、手数料があれば実質の利率は上がります。

手数料がない場合はどうなりますか？

借入額と受け取る金額が同じになり、実質年率は丸めを除いて表示金利と一致します。ゼロより大きい手数料を組み込むと、表示金利を上回ります。

金利0パーセントのローンでも実質年率がプラスになりますか？

手数料を組み込めばなります。返済は手数料を含む全額に対して行いますが、受け取ったのは差し引いた金額だけなので、手数料分だけのプラスの実質年率が出ます。

手数料で毎月の返済額はどれだけ増えますか？

返済額は必要な金額に手数料を足した総額で計算されるため、手数料なしで同じ金額を借りる場合より高くなります。例では204,000に対する返済額が月1,289.4188です。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/finance/loan-apr-from-fees

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/finance/loan-apr-from-fees \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"loan_amount":200000,"annual_rate_percent":6.5,"term_months":360,"fees":4000}'

const res = await fetch("https://api.kit.forhosting.com/finance/loan-apr-from-fees", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "loan_amount": 200000,
    "annual_rate_percent": 6.5,
    "term_months": 360,
    "fees": 4000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/loan-apr-from-fees",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "loan_amount": 200000,
    "annual_rate_percent": 6.5,
    "term_months": 360,
    "fees": 4000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/loan-apr-from-fees", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"loan_amount":200000,"annual_rate_percent":6.5,"term_months":360,"fees":4000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"loan_amount":200000,"annual_rate_percent":6.5,"term_months":360,"fees":4000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/loan-apr-from-fees", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "loan_amount": 200000,
  "annual_rate_percent": 6.5,
  "term_months": 360,
  "fees": 4000
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.loan_apr_from_fees",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

同一の純粋モジュールが無料ブラウザ経路と前払いAPIを駆動するため、デモと本番で計算例が食い違うことはありません。不正な入力は invalid_input で失敗し、課金されません。

入力契約・出力・丸め・計算例

任意の decimals は零から十二の整数（既定四）で、応答の金額・金利欄に一度だけ half-up 丸めを適用します。例：二十万が六・五パーセント・三百六十か月・融資手数料四千なら名目は二十万四千、返済は手数料なしよりやや高く、実質年率は六・五をわずかに上回ります。手数料零の同一ローンでは、丸め後に実質年率は表示金利と等しくなります。現地法が特定のAPR日数計算や前払い金融費用の定義を求める場合は、ご自身の開示文と組み合わせてください。POST で JSON 本文に四つの必須フィールドを送ります。loan_amount は純受取額で零より大きい有限数、annual_rate_percent は非負の表示名目年利（パーセント単位で、六・五は六・五パーセント）、term_months は正の整数の償却月数、fees は名目に組み込む非負の有限金額です。欠落・空文字・非有限・負の手数料や金利・非正のローン額・非整数または非正の期間は invalid_input で問題を示して失敗し、課金されません。成功時は入力をエコーし、face_amount をローン＋手数料、monthly_payment を名目上の償却額、total_of_payments と total_interest を全期間、net_proceeds を loan_amount、true_apr_percent を手数料調整後の名目APR、apr_premium_percent を実質年率マイナス表示金利、短い formula 文字列を返します。本エンドポイントは定額返済・手数料融資モデルに基づく教育・比較用の推定であり、すべての法域における規制上の貸付開示計算の代替ではありません。

手数料調整ローンAPR計算が役立つ場面

実装は純粋な parse のティア A のため、成功した呼び出しは毎回公開の基本料金 $0.002 で、モデルトークンも外部ネットワークも使いません。loan_amount と fees を同一通貨単位に保ち、テストで丸め済み true_apr_percent を固定すれば、市販の住宅ローンエンジンを立てずに表計算・n8n フロー・エッジワーカー向けに再現可能な手数料調整APRが得られます。

連携の活用例

教育と CMS ウィジェット

前払いAPI経路と同じ決定的契約で、宿題用オラクルやページ上の計算機を動かします。

技術的な質問

手数料を融資する場合、実質年率はどう計算しますか？

名目額は loan_amount に fees を足したものです。定額月払いはその名目を表示金利で償却します。実質年率は、それらの返済の現在価値を loan_amount（純受取額）に一致させる月利の十二倍です。

手数料が零の場合は？

名目は loan_amount と一致するため、数理金利は表示金利と一致し、half-up 丸め後 true_apr_percent は annual_rate_percent と等しくなります。

金利は小数とパーセントのどちらで入れますか？

annual_rate_percent はパーセント単位です（例：6.5 は 6.5%）。true_apr_percent と apr_premium_percent もパーセントです。

手数料込みローンAPR計算の料金は？

ブラウザツールは無料です。API は成功呼び出しごとに前払い KIT 残高から $0.002 です。不正入力は課金されません。

KITの完全なドキュメントを見る →

手数料込みローンAPR計算

無料で実行

計算例

融資手数料が実質年率に与える影響

手数料調整ローンAPR計算が役立つ場面

活用例

融資手数料込みのローン見積比較

ブローカー・アドバイザーのライブ試算

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

お使いのスタックから呼び出す

リクエスト例

レスポンス例

料金

エラー

技術的な注記

入力契約・出力・丸め・計算例

手数料調整ローンAPR計算が役立つ場面

連携の活用例

教育と CMS ウィジェット

技術的な質問

ありがとう