ForHosting KIT · 金融・お金

残予算計算機

収入5,000から、住居、食費、交通、光熱費、サブスクリプションの支出2,700を引くと、残りは2,300で黒字です。ご自身の収入と支出をカテゴリーごとに入れれば、その期間に残る金額が分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

収入: 5,000

結果

経費の件数: 5
支出合計: 2,700
残り: 2,300
ステータス: surplus

この残予算計算機は、分類した経費の一覧を総収入から差し引き、その期間が剰余で閉じるか不足で閉じるかを報告します。有限で非負の income と、category ラベルと amount を持つ経費行を少なくとも一行送ります。エンジンは各 amount を合計し、remaining を income からその合計を引いた値として求め、符号を surplus、deficit、balanced に分類します。インフレ経路も税表も通貨換算もなく、試験に固定して分類内訳の横に示せる決定的な引き算だけです。

残予算の意味と、剰余または不足の符号の付け方

残予算とは、同じ期間の収入から掲げた支出をすべて取り出したあとに残る額です。月、給与サイクル、案件の封筒のいずれでも構いません。この計算機はインフレを予測せず、通貨を換算せず、税表も適用しません。

有限で非負の income と、同じ通貨の category ラベルと amount を持つ分類済み経費行の一覧を読み、remaining が income からそれらの合計を引いた値であるという閉じた恒等式を適用します。正の余りは surplus、負の余りは不足額を大きさとする deficit、ゼロの余りは balanced です。

category ラベルは応答に載るので、家計、教室、スクリプトが住居・食費・交通のどこに支出が載ったかを示せます。share は行の amount を経費合計で割った値で、合計がゼロならゼロです。負の経費値はこのモデルの外です。

income 自体も非負かつ有限でなければなりません。

入力契約、拒否される行、成功応答の形

income はその期間に使える総額です。各オブジェクトは、余白を除いたあと空でない文字列の category と、有限で非負の数である amount を必要とします。各行では amount の別名 value と cost を尊重します。

いずれかの経費 amount が負なら、経費値は負にできないというメッセージで拒否されます。これが本計算機の硬い契約であり、その失敗は課金されません。金額欄は小数二桁に丸め、share は十二桁です。

任意の出力鍵は null にせず省略します。

残予算計算機が役立つ場面

家計は給与が入ったとき、家賃・食料・通勤・光熱・定期課金を差し引いたあとの余りを一つの数で知り、裁量支出を計画する前に残予算計算機を使います。学生は、ラベル付き支出一覧から月次封筒が剰余か不足かを問う個人財務の単元で同じ恒等式に出会います。教員は、貯蓄率の規則やインフレを単純な引き算に混ぜる不透明な応用に頼らず、控えめな収入数字の解答キーを作れます。

開発者は、予算応用の決定的な試験固定を種まきするため、ダッシュボード図の前に利用者が入れた分類合計を整えるため、負の支出が黙った貸方になってはならない供給を閉じた失敗にするため、同じ契約をスクリプトから呼びます。指導用具は、学習者が生の行の壁ではなく残金を見るよう、進捗バーの横に surplus または deficit 額を置きます。

この頁では作業はすべてブラウザ内で走ります。

活用例

家計の給与の余り

家賃・食費・交通・請求を手取りから差し引き、その月が剰余で閉じるか不足で閉じるかを見ます。

教室での封筒点検

ラベル付き支出一覧と既知の収入を学生に渡し、残予算を剰余または不足の解答と照合させます。

決定的な予算の試験固定

既知の income と分類経費から、安定した remaining・surplus・deficit を CI と製品の計算機へ種まきします。

よくある質問

残予算はどう計算しますか？

remaining = income − 各経費 amount の合計です。正の余りは surplus、負の余りは deficit（正の不足として報告）、ゼロは balanced です。

どの欄を送りますか？

各経費行には空でない category と非負の amount が必要です。

応答の status は何を意味しますか？

status は remaining が正なら surplus、負なら deficit、小数二桁の丸めのあとちょうどゼロなら balanced です。

カテゴリーごとの支出の割合も分かりますか？

分かります。各カテゴリーの横に支出全体に占める割合が表示されます。例では住居が2,700のうち1,800で3分の2を占め、家計を最も圧迫している項目がすぐに分かります。

支出は何項目まで入力できますか？

1項目から200項目まで入力でき、それぞれに家賃や食費などの名前と、収入と同じ通貨の金額を付けます。支出がマイナスになることはないため、負の金額は受け付けません。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

curl -X POST https://api.kit.forhosting.com/fin/budget \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"income":5000,"expenses":[{"category":"Housing","amount":1800},{"category":"Food","amount":450},{"category":"Transport","amount":220},{"category":"Utilities","amount":180},{"category":"Subscriptions","amount":50}]}'

const res = await fetch("https://api.kit.forhosting.com/fin/budget", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "income": 5000,
    "expenses": [
      {
        "category": "Housing",
        "amount": 1800
      },
      {
        "category": "Food",
        "amount": 450
      },
      {
        "category": "Transport",
        "amount": 220
      },
      {
        "category": "Utilities",
        "amount": 180
      },
      {
        "category": "Subscriptions",
        "amount": 50
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/budget",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "income": 5000,
    "expenses": [
        {
            "category": "Housing",
            "amount": 1800
        },
        {
            "category": "Food",
            "amount": 450
        },
        {
            "category": "Transport",
            "amount": 220
        },
        {
            "category": "Utilities",
            "amount": 180
        },
        {
            "category": "Subscriptions",
            "amount": 50
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/budget", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"income":5000,"expenses":[{"category":"Housing","amount":1800},{"category":"Food","amount":450},{"category":"Transport","amount":220},{"category":"Utilities","amount":180},{"category":"Subscriptions","amount":50}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"income":5000,"expenses":[{"category":"Housing","amount":1800},{"category":"Food","amount":450},{"category":"Transport","amount":220},{"category":"Utilities","amount":180},{"category":"Subscriptions","amount":50}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/budget", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "income": 5000,
  "expenses": [
    {
      "category": "Housing",
      "amount": 1800
    },
    {
      "category": "Food",
      "amount": 450
    },
    {
      "category": "Transport",
      "amount": 220
    },
    {
      "category": "Utilities",
      "amount": 180
    },
    {
      "category": "Subscriptions",
      "amount": 50
    }
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.budget",
  "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 で拒否されます。このモデルでは支出行がゼロ未満になってはならないためです。同じ純粋な算術が無料のブラウザ用具と API 経路を動かすので、家計の表と自動化スクリプトが余りで食い違うことはありません。

残予算の意味と、剰余または不足の符号の付け方

支出行はゼロ未満になれないため、エンジンは問題の行を名指しして invalid_input で失敗し、払い戻しを黙って貸方にひっくり返すことはしません。経路は純粋な算術であり、Date も乱数もネットワーク I/O もないので、同じ入力は常に同じ JSON と、表や単体試験に固定できる同じ surplus または deficit 額を返します。

入力契約、拒否される行、成功応答の形

必須の二欄を持つ JSON 本体を POST してください。表計算や型付きフォームが同じ契約を再利用できるよう、別名 total_income、salary、revenue を受け付けます。expenses は一件から二百件の空でない配列で、別名 items、costs、spending は同じ一覧を指します。有限小数として解釈できる数値文字列は受け付け、空文字、NaN、Infinity は欄名を添えた invalid_input で失敗します。income の欠落、expenses 一覧の欠落または空、category の欠落、二百行を超える場合も失敗します。成功時は本体が income、expense_count、きれいにした経費行と share を返し、total_expenses、remaining、status（surplus、deficit、balanced）、surplus（remaining が正ならその値、さもなくばゼロ）、deficit（remaining が負なら絶対不足、さもなくばゼロ）、formula 文字列を報告します。

残予算計算機が役立つ場面

API では成功した照会ごとに $0.002 がかかり、検証失敗は課金されず、応答のあと何も保存しません。表の実演から自動化パイプラインへ移るとき、数学の結果を変えず引き算を自分で書き直さずに済むよう、無料の対話実行と料金の同じ API を対にしてください。

技術的な質問

経費の amount が負だとどうなりますか。

要求は invalid_input で失敗します。この計算機では経費値を負にできず、検証失敗は課金されません。

予算計算機の料金はいくらですか。

ブラウザ用具は無料です。API 要求は成功した呼び出しごとに前払い KIT 残高から $0.002 を使い、無効な入力は課金されません。

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

残予算計算機

無料で実行

計算例

残予算の意味と、剰余または不足の符号の付け方

入力契約、拒否される行、成功応答の形

残予算計算機が役立つ場面

活用例

家計の給与の余り

教室での封筒点検

決定的な予算の試験固定

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

残予算の意味と、剰余または不足の符号の付け方

入力契約、拒否される行、成功応答の形

残予算計算機が役立つ場面

技術的な質問

ありがとう