ForHosting KIT · 金融・お金

TRIR計算機

Q: リターンはパーセントですか、小数ですか？

パーセントです。 八パーセントの期には 8 を送ってください。0.08 を送ると八パーセントではなく、百分の八パーセントとして扱われます。

年8%、-2%、5%のリターンをつなぐと合計は11.132%になります。損失で元手が減ると、その後の利益の増え方も変わるためです。1年あたりの期間数を指定すれば、年率換算した複利リターンも分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

リターン: 8, -2, 5
年間の期間数: 1

結果

N: 3
年数: 3
成長率: 1.11132
総リターン: 11.132

総合統合収益率はしばしば TRIR と略され、期間ごとの結果の列が、単純平均ではなく成長係数を幾何的につないだときに実際に生んだ複利の成長です。プラス八、マイナス二、プラス五パーセントの単純平均は、損失が後の利益の複利の土台を縮めるため、ポートフォリオがたどった経路を過大に見ます。この計算機は空でない期間リターンのパーセント一覧を受け取り、一に各利率を足した成長係数を掛け合わせ、年あたりの期間数で積を年率換算し、見出しの数値を複利の年率換算収益にします。空のリターン一覧は無効な入力であり、課金されません。

TRIR の意味と積の年率換算

期間リターンの一覧は、成長係数を掛け合わせるまで単一の利率ではありません。第一期が八パーセントを稼ぎ、第二期が二パーセントを失い、第三期が五パーセントを稼いだなら、富の相対は 1.08 かける 0.98 かける 1.05 であり、三つのパーセントの算術平均ではありません。その積から一を引いた値が、窓全体の総合統合収益率です。

挙げた各期に一単位を投資し続けたときに得られる保有期間の結果です。長さの違う窓を比べるにはなお共通の時計が要るので、計算機は同じ積を p を n で割った値乗し、一を引きます。n は挙げた期間の数、p は暦年に収まるその期間の数です。

p が一時は一覧を年次観測として扱い、年率換算値は成長係数の幾何平均から一を引いた値です。p が十二なら一年分の月次観測は一歩で年率換算され、二十四の月次観測は二年にまたがり、指数は二分の一になります。ちょうどマイナス百パーセントの期は全滅で、積は零、年率換算収益はマイナス百パーセントです。

マイナス百パーセントより悪い収益は成長係数を負にし、分数指数のもとで実数を離れるため、複素数を返す代わりにその項目は拒否されます。

入力契約、空の一覧、応答の形

returns は有限パーセントの空でない配列です。八はその期の八パーセントを意味し、本当に百分の八パーセントを意図するのでなければ小数 0.08 ではありません。空一覧の契約メッセージは、returns が期間リターンの空でない一覧でなければならないと述べます。

年次系列は一、四半期は四、月次は十二、週次は五十二、日次は三百六十五を使います。ゼロ、負の値、2.5 のような分数は黙って丸めず拒否されます。検証失敗は残高を消費しません。

一覧は一万期以下に保ってください。

活用例

期間ごとのポートフォリオ収益の鎖を年率換算する

月次または四半期のパーセント収益を一つの保有期間 TRIR と対応する複利年率換算収益へつなぎ、経路を始点終点の CAGR に潰しません。

教室と CFA 向けの時間加重解答キー

同じ一覧について、期間利率の算術平均と成長係数の積を区別する、再現可能な幾何連結の結果を生成します。

よくある質問

総合統合収益率（TRIR）はどう計算しますか？

各期のパーセントを成長係数 1 + r に直し、それらの積から一を引いた値が保有期間の TRIR です。

リターンはパーセントですか、小数ですか？

パーセントです。八パーセントの期には 8 を送ってください。0.08 を送ると八パーセントではなく、百分の八パーセントとして扱われます。

リターンの一覧が空だとどうなりますか？

計算は行われません。少なくとも1つの期間リターンが必要で、空の一覧は受け付けないためです。

月次のリターンはどう年率換算しますか？

1年あたりの期間数を12にします。12か月分なら一度で年率換算でき、24か月分は2年分にあたるため、掛け合わせた値を2分の1乗してから1を引きます。

-100%の期間があるとどうなりますか？

全損として扱われ、掛け合わせた値は0、年率換算リターンは-100%になります。-100%より悪い値は、成長率がマイナスになり実数で年率換算できないため受け付けません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/fin/trir

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

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

curl -X POST https://api.kit.forhosting.com/fin/trir \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"returns":[8,-2,5]}'

const res = await fetch("https://api.kit.forhosting.com/fin/trir", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "returns": [
      8,
      -2,
      5
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/trir",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "returns": [
        8,
        -2,
        5
    ]
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"returns":[8,-2,5]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/trir", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "returns": [
    8,
    -2,
    5
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 10000

エラー

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

技術的な注記

入力契約、空の一覧、応答の形

必須欄 returns を持つ JSON 本体を POST してください。alias の periodic_returns、rates、r は同じ一覧を指すので、表計算の列は慣れた名前を保てます。returns が欠落、空、または有限数の一覧でない場合、タスクは returns を名指しして invalid_input で失敗し、課金されません。任意の periods_per_year は一から三百六十五の正の整数で、省略時は一です。alias の frequency、ppy、compounds_per_year を受け付けます。各スカラーは JSON の数でも数値文字列でもよく、一覧自体は JSON 配列でもカンマ区切り文字列でも構いません。成功時は本体が returns を返し、n と periods_per_year を報告し、years を n を p で割った値として与え、growth_factor に加えてパーセントの total_return、分数の total_return_decimal、パーセントの annualized_return、分数の annualized_return_decimal、および積の恒等式を述べる formula 文字列を返します。

TRIR 計算機が役立つ場面

運用チームは、月次のファンド票、四半期のマンデート報告、拠出調整済みの年次時間加重収益など、すでに期間ごとの結果の鎖があり、経路を無視する始点終点の CAGR ではなく複利の年率換算相当を問うときに総合統合収益率の計算機を使います。学習者と CFA 受験者は、宿題の系列を幾何的につなぎ、壊れたフォームが成功とみなしうる静かな NaN ではなく空一覧を拒否する決定的な神託を必要とします。製品チームは同じ契約を導入デモに結び、periods_per_year を十二にした十二個の月次パーセントを貼った利用者が、本番試験で API が後から返すのと同じ annualized_return を見るようにします。実装は段階 A の純粋 parse なので、成功した呼び出しは公開された基本料金 $0.002 で、モデルトークンも外向きネットワークもありません。要求を小さく保ち、丸めた annualized_return を試験に固定すれば、表計算サービスを自ら立てずにワークシート、LMS プラグイン、エッジワーカー向けの再現可能な TRIR 数値が得られます。

連携の活用例

製品デモと結合試験の固定値

無料のブラウザウィジェットとバイト単位で一致する決定的な annualized_return 値で、実績ウィジェットと自動試験を初期化します。

技術的な質問

リターンの一覧が空だとどうなりますか？

タスクは invalid_input で失敗します。空でない一覧が必須で、空の配列は拒否され、課金されません。

periods_per_year は年率換算値をどう変えますか？

G^(p/n) − 1 の p を定めます。既定の 1 は挙げた各リターンを年次として扱います。月次系列は 12、四半期は 4、週次は 52、日次は 365 を使い、長い窓が正しい年数で年率換算されるようにします。

TRIR 計算機の料金はいくらですか？

ブラウザの用具は無料です。API 要求は成功一件あたり $0.002 の前払い KIT 残高を使い、空のリターン一覧を含む無効な入力は課金されません。

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

TRIR計算機

無料で実行

計算例

TRIR の意味と積の年率換算

入力契約、空の一覧、応答の形

活用例

期間ごとのポートフォリオ収益の鎖を年率換算する

教室と CFA 向けの時間加重解答キー

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

制限

エラー

技術的な注記

入力契約、空の一覧、応答の形

TRIR 計算機が役立つ場面

連携の活用例

製品デモと結合試験の固定値

技術的な質問

ありがとう