ForHosting KIT · 開発者向けツール

Social Security給付額計算

このSocial Security給付額計算ツールは、平均インデックス月収を推定一次保険金額へ変換します。これは受給開始年齢による調整前の月額です。AIMEを計算式の低・中・高という三つの区分に分け、それぞれに所得代替率を適用し、すべての小計を表示します。明示された既定のベンドポイントをそのまま使うことも、対象者の受給資格年度に対応する値へ変更することもできます。そのため、計算過程を確認でき、同じ入力から同じ結果を再現できます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

正しいAIMEとベンドポイント年度をご用意ください

平均インデックス月収（AIME）は、現在の給与、直近の月給、または就労期間全体の単純平均とは異なります。Social Securityの所得記録では、対象所得をまず指数調整し、適用される計算年を選び、合計額を制度上の規則に従って月平均へ換算します。この計算ツールは、その処理が済んだ段階から計算を始めます。そのため、適切な記録または計算から得たAIMEをご入力ください。年ごとの給与からAIME自体を算出する機能ではありません。ベンドポイントは、推定を行う暦年や受給を開始する年ではなく、原則として対象者が初めて受給資格を得る年によって決まります。既定の下限値と上限値は、2025年の公表値である1,226ドルと7,391ドルです。別の受給資格年度では、その年に公式発表された二つの値へ置き換えてください。AIMEと年度が合わないベンドポイントを組み合わせると、もっともらしく見えても誤った結果になる場合があります。本ツールは、下限値が正であり、上限値が下限値より大きいことも検証します。

三段階の代替率からPIAができる仕組みをご確認ください

この計算式は累進的で、後の区分よりも最初の区分で高い割合の所得を置き換えます。まずAIMEを第一ベンドポイントまで割り当て、残額を第一と第二の間へ配分し、第二を超える額を第三区分へ入れます。既定では各部分に90、32、15パーセントを掛けます。結果には、各区分のAIME額と給付への寄与額が含まれるため、最終値だけでなく計算内容も確認できます。AIMEが第一ポイント未満なら中・上位区分はゼロで、両方の点の間なら最初の二区分だけが寄与します。三つの寄与額は`pia_before_dime_rounding`に合計され、説明のためセント単位で表示されます。その後、推定月額PIAを直下の十セント単位へ切り下げます。これは通常の四捨五入とは異なり、未処理額が2,345.67なら2,345.60になります。代替率は検証用に変更できますが、一般的な労働者向け計算では通常、標準値を維持してください。

推定値の範囲を正しくご理解ください

推定月額PIAは計算式の基準値であり、実際に口座へ振り込まれる金額と一致するとは限りません。一般にPIAは、満額受給年齢に対応する開始額であり、他の規定や受給時期の選択を反映する前の数値です。早期受給では支給額が減る場合があり、繰下げによるクレジットでは増える場合があります。生活費調整、Medicare保険料、源泉徴収、家族上限、扶養・遺族給付、障害給付規則、特別な法定規定なども実際の支給額に影響します。本機能はこれらを計算せず、受給開始日を予測せず、金融助言も行いません。目的は限定的で、AIME、二つのベンドポイント、三つの率から、毎回同じ監査可能な区分別計算を返すことです。表計算の確認、累進的な所得代替の説明、給付設計画面のテスト、公式年度間の比較に内訳をご利用ください。個人の判断では、公式情報または有資格の専門家に所得記録と前提をご確認ください。ブラウザー版は無料で、自動APIリクエストは$0.002です。

活用例

退職計画表の検算

既知のAIMEと受給資格年度のベンドポイントからPIAを再計算し、各区分を計画表と照合できます。

累進的な所得代替の説明

90、32、15パーセントの各区分が、推定月額給付へ異なる金額を加える仕組みを示せます。

給付アプリケーションのテスト

決定論的なAPIを使い、フォーム、計算ツール、退職学習ソフト向けの監査可能な期待値を生成できます。

よくある質問

AIMEとは何ですか？

平均インデックス月収のことで、対象所得からSocial Securityの指数調整・計算規則に従って導出されます。単なる直近の月給ではありません。

どのベンドポイントを使えばよいですか？

適用規則上、対象者が初めて受給資格を得る年の値をご使用ください。既定値は2025年の値と明記されており、変更できます。

なぜ十セント単位で切り下げるのですか？

PIA計算式では直下の十セント単位へ切り下げます。差をご確認いただけるよう、回答には切り下げ前の合計も含まれます。

推定月額PIAが実際の受取額ですか？

必ずしも一致しません。受給年齢、生活費調整、Medicare控除、源泉徴収、家族規定などにより実際の支給額は変わります。

この計算ツールの料金はいくらですか？

ブラウザーでは無料でご利用いただけます。APIの各リクエストは$0.002で、外部ネットワークサービスは使用しません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/finance/social-security-estimate

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

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

curl -X POST https://api.kit.forhosting.com/finance/social-security-estimate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"aime":5000}'

const res = await fetch("https://api.kit.forhosting.com/finance/social-security-estimate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "aime": 5000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/social-security-estimate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "aime": 5000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/social-security-estimate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"aime":5000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"aime":5000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/social-security-estimate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "aime": 5000
}

レスポンス例

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

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