ForHosting KIT · 金融・お金

実効年利計算機

四半期で2%の利回りは、年率にすると8%ではなく約8.24%になります。各四半期の利益が次の四半期にも利益を生むためです。1期間の利回りと、1年に入る期間の数を入れてください。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

保有期間利回り: 2
年間の期間数: 4

結果

保有期間利回り (小数): 0.02
実効年利回り: 0.08243216
実効年間利回り (%): 8.243216

手形・ノート・その他の短期商品に表示される利回りは、多くの場合保有期間利回りです。クーポン窓、四半期、または短期金融資産の残存期間で得たリターンであり、債券利回りや貯蓄の APY、別カレンダーで複利する商品と比べるには、共通の年次尺度へ直す必要があります。実効年利はその直しかたを複利で行います。EAY は 1 に保有期間利回りを足し、1年に入る期間数乗し、1 を引いた値です。四半期 2 パーセントの保有期間利回りは年 8 パーセントではなく、4 回の複利でおよそ 8.24 パーセントになります。

実効年利の意味と公式が複利する仕組み

保有期間利回りは、離散的な一区間における価値のパーセントまたは小数の変化です。財務省短期証券の満期までの 3 か月、クーポン日間の 6 か月、あるいは商品が実際に使う再表示期間です。その窓でいくら得たかを答え、その窓が 1 年とどう比べるかは答えません。

四半期利回りを 4 倍するような名目の近道は年内複利を無視し、期間利回りが正なら真の年率を過小評価します。実効年利は複利を戻します。小数比率の保有期間利回りを HPY、1 年に入るその期間の個数を m と書くと、EAY は 1 に HPY を足して m 乗し、1 を引いたものです。

3 か月物が 2 パーセントなら HPY は 0.02、m は 4 なので、EAY は 1.02 の 4 乗から 1 を引いた 0.08243216、すなわち 8.243216 パーセントであり、線形年率化が示す 8 パーセントではありません。m が 1 なら保有期間がすでに 1 年なので EAY は HPY と一致します。

HPY がゼロなら EAY もゼロです。HPY が負でもマイナス 100 パーセントより大きければ EAY は負となり、複利の年間下落を表します。マイナス 100 パーセント以下では 1 足す HPY がゼロ以下になり、この恒等式は複利できないため、計算機は非有限の結果を返さずそのケースを拒否します。

年間期間数は厳密に正でなければなりません。ゼロは頻度ではなく、負の m は成長倍率を存在しないカレンダーへ反転させます。

実効年利計算機が役立つ場面

CFA 受験者と債券デスクは、短期金融の気配、Tビルの保有期間リターン、クーポン期間利回りを、債券の YTM や貯蓄 APY と並べられる複利年率へ直すときに実効年利計算機を使います。商品・財務チームは四半期・月次・日次の商品を、m 倍して複利と称さずに一画面で比べます。

保有期間利回り、銀行割引利回り、名目 APR、実効年利の違いを教える教育者は、四半期 2 パーセントが年 8.24 パーセントに複利する教室例を用意し、頻度ゼロを打ったときの硬い失敗も示せます。検証失敗は残高を消費しません。

活用例

短期金融の保有期間利回りを再表示する

Tビルやコマーシャルペーパーの保有期間リターンと年間期間数を、債券や貯蓄 APY と比べられる複利の実効年利へ変換します。

教室および CFA 形式の検算

四半期・半年・月次の例で EAY = (1 + HPY)^m − 1 を確かめ、年間期間数がゼロまたは負のときに要求される失敗も含めます。

商品と財務の比較

異なるカレンダーのクーポン期間利回りや支払期間利回りを、報告書と APIs で一つの複利年次尺度へ正規化します。

よくある質問

保有期間利回りから実効年利はどう計算しますか？

恒等式は EAY = (1 + HPY)^m − 1 です。HPY は小数の保有期間利回り、m は 1 年に入るその期間の個数です。計算機は同じレートをパーセントでも返します。

四半期 2% の利回りが年 8% にならないのはなぜですか？

線形の年率化は 2% を 4 倍するだけで複利を無視します。(1.02)^4 − 1 は 0.08243216、およそ 8.24% であり、それが実効年利です。

保有期間利回りとは何ですか？

一定の期間に得たリターンのことです。短期国債の満期までの3か月や、利払い日の間の6か月など、商品が使う期間での利益を表し、そのままでは1年あたりの比較はできません。

1年あたりの期間数はいくつを入れますか？

1年に入る保有期間の数です。年1回なら1、半年ごとなら2、四半期なら4、毎月なら12、毎週なら52、毎日なら365です。ゼロより大きい値が必要で、端数も使えます。

保有期間利回りがマイナスでも計算できますか？

マイナス100%より大きければ計算できます。結果は負の実効年利回り、つまり複利での年間の減少になります。100%以上の損失は複利計算ができないため受け付けません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/effective-annual-yield

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

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

curl -X POST https://api.kit.forhosting.com/fin/effective-annual-yield \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"holding_period_yield":2,"periods_per_year":4}'

const res = await fetch("https://api.kit.forhosting.com/fin/effective-annual-yield", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "holding_period_yield": 2,
    "periods_per_year": 4
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/effective-annual-yield",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "holding_period_yield": 2,
    "periods_per_year": 4
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/effective-annual-yield", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"holding_period_yield":2,"periods_per_year":4}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"holding_period_yield":2,"periods_per_year":4}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/effective-annual-yield", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "holding_period_yield": 2,
  "periods_per_year": 4
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.effective_annual_yield",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

本計算機は期間利回りと年間期間数を受け取り、年率を小数とパーセントで返し、期間数がゼロまたは負なら invalid_input で拒否し、誤ったカレンダーが無限レートに化けるのを防ぎます。

入力契約、応答の形、エラー時の振る舞い

1 は年次、2 は半年、4 は四半期、12 は月次、52 は週次、365 は日次です。ゼロより厳密に大きい有限数でなければならず、再表示が端数頻度を使うなら端数も認めます。小数の保有期間利回りに 1 を足したものが厳密に正でなければ複利は未定義となり、タスクは失敗します。POST で必須の有限数 holding_period_yield と periods_per_year を含む JSON ボディを送ってください。既定では holding_period_yield はパーセントで、2 は保有期間利回り 2 パーセントを意味します。同じ 2 パーセントを小数比率で送るには as_percent を false にし、0.02 を渡します。periods_per_year は 1 年に入る保有期間の個数です。任意の整数 decimals（0〜12、既定 8）は holding_period_yield_decimal、effective_annual_yield、effective_annual_yield_percent に一度だけ half-up 丸めを適用します。利回りの別名は hpy と periodic_yield、頻度の別名は m と frequency です。各数値欄は JSON 数でも数値文字列でも構いません。欠落欄、空文字列、真偽値、非有限値は invalid_input で欄名を示して失敗し、課金されません。periods_per_year がゼロまたは負なら、非正の複利頻度はカレンダーではないため、ゼロより大きくなければならないというメッセージで失敗します。成功時は holding_period_yield、periods_per_year、as_percent をエコーし、べき乗に使った HPY である holding_period_yield_decimal、小数比率の effective_annual_yield、それを 100 倍した effective_annual_yield_percent、および eay = (1 + hpy)^m - 1 を再掲する公式文字列を返します。例：holding_period_yield 2、periods_per_year 4 は実効年利 0.08243216、すなわち 8.243216 パーセントです。

実効年利計算機が役立つ場面

期間リターンと支払カレンダーをすでに持つ自動化は、その 2 数を POST し、各サービスでべき乗を再導出せずテストで effective_annual_yield を固定できます。実装は純粋 parse の tier A のため、成功した呼び出しは公開の基本価格 $0.002 で、モデルトークンも外向きネットワークも不要です。リクエストを小さく保ち、丸め済み利回りをテストで固定すれば、表計算のゴールシークや自前の債券ライブラリなしで、宿題・LMS プラグイン・エッジワーカー向けに再現可能な EAY を得られます。

技術的な質問

年間期間数がゼロまたは負だとどうなりますか。

タスクは invalid_input で失敗します。非正の periods_per_year は複利頻度ではないため、要求は拒否され課金されません。

保有期間利回りはパーセントと小数のどちらで入れますか。

既定では as_percent が true なので 2 は 2% です。同じ利回りを小数で送るには as_percent を false にし、0.02 を渡してください。

実効年利計算機の料金はいくらですか。

ブラウザツールは無料です。API 要求は成功した呼び出しあたり $0.002 の前払い KIT 残高を使い、無効入力は課金されません。

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

実効年利計算機

無料で実行

計算例

実効年利の意味と公式が複利する仕組み

実効年利計算機が役立つ場面

活用例

短期金融の保有期間利回りを再表示する

教室および CFA 形式の検算

商品と財務の比較

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

入力契約、応答の形、エラー時の振る舞い

実効年利計算機が役立つ場面

技術的な質問

ありがとう