ForHosting KIT · 金融・お金

指定為替レートで通貨を換算

Q: リアルタイムの為替レートを取得しますか？

いいえ。 お客様が為替レートを明示的に指定し、レート提供元へ接続せずにその値を使用します。

Q: 通貨の小数桁に合わせて丸めますか？

いいえ。 乗算結果を直接返します。通貨、元帳、決済事業者、契約で求められる丸め規則を別途適用してください。

Q: 負の金額も換算できますか？

はい。 為替レートが正数であれば、貸方、返金、取消、同様の会計処理に負の金額を使用できます。

元の通貨1単位で換算先の通貨が0.92単位買えるなら、0.92と入力すると金額にちょうどその率が掛けられます。手数料、スプレッド、丸めは加えません。請求書や銀行の換算の確認に使えます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

量: 125.5
換算元の通貨: usd
換算先の通貨: EUR
為替レート: 0.92

結果

換算元の通貨: USD
換算後の金額: 115.46

この固定レート通貨換算ツールは、金額、換算元と換算先の通貨、そしてお客様が指定した為替レートから換算額を計算します。銀行、決済事業者、契約書、請求書、表計算、会計手続ですでに適用レートが決まっており、外部のレート情報に依存せず、透明で再現可能な計算が必要な場合に適しています。

為替レートの向きを正しく指定します

金額を換算元通貨で入力し、換算元と換算先を3文字の通貨コードで指定して、換算元通貨1単位に対して受け取る換算先通貨の単位数を入力してください。たとえば、換算元1単位が換算先0.92単位に相当する場合、為替レートは0.92です。向きは重要であり、換算元と換算先を入れ替える場合は、通常、同じ数値ではなく逆数のレートが必要です。

このツールの目的は取引に適用される明示的なレートを使うことなので、レートの推測、反転、検索は行いません。通貨コードは結果で大文字に統一されるため、usd と USD は同じ識別子として扱われます。金額には正数、ゼロ、負数を指定でき、通常の支払いだけでなく、返金、貸方、取消、会計調整にも対応できます。

一方、為替レートはゼロより大きい有限の数値でなければなりません。ゼロまたは負のレートは誤解を招く結果を返さず、無効な入力として拒否されます。

結果の計算方法を正確に確認できます

換算には、換算額は元の金額に指定レートを掛けた値である、という1つの直接的な式だけを使用します。スプレッド、手数料、税、上乗せ、最低料金、丸め規則は追加しません。そのため、適用されるべき正確なレートが分かっている場合に、別システムの結果を検算できます。

応答には、受け付けた金額、正規化した通貨コード、為替レート、換算額が含まれ、監査記録に答えと前提を一緒に残せます。計算は JavaScript の標準的な有限数を使用し、決定的です。また、通貨ごとの小数桁数を強制しません。

一般に小数2桁で表示する通貨もあれば、0桁や3桁の通貨もあり、金融システムでは中間計算にさらに高い精度を保持する場合があります。請求書、元帳、決済事業者、契約で必要な丸め規則を換算後に適用してください。

再現可能な処理には固定レートが適しています

為替レートが計算そのものとは別の情報源で決められている場合、固定レート換算が適しています。カード利用明細に記載されたレート、特定の報告期間に承認された財務レート、貨物に対して公表された税関レート、請求日付で固定された契約レートなどが例です。レートの選択と乗算を分離すると、その後に市場が変動しても、すでに確定した結果は変わりません。

テストも容易になり、入力を記録とともに保存しておけば、換算額の算出根拠を示す必要があるときに再実行できます。このツールはリアルタイムの外国為替相場を提供するものではありません。指定レートが最新、有利、適切かどうかは判断せず、事業者の手数料も含めません。

同じ決定的な処理をブラウザーでも実行できるため、異なるレートサービスに依存せず手動計算と自動計算を比較できます。

活用例

決済明細を照合します

銀行や決済事業者が示したレートを適用し、計算した換算額と記帳された取引を比較できます。

固定レートで請求額を換算します

請求書に記録された契約レートを、新しい市場レートに置き換えずに使用できます。

金融ソフトウェアをテストします

既知の金額とレートを指定し、取込処理、元帳、決済システム向けの再現可能なテストを作成できます。

よくある質問

リアルタイムの為替レートを取得しますか？

いいえ。お客様が為替レートを明示的に指定し、レート提供元へ接続せずにその値を使用します。

為替レートはどちら向きで指定しますか？

換算元通貨1単位に対する換算先通貨の単位数を指定してください。向きを逆にする場合は、適切な逆数レートを計算して指定します。

通貨の小数桁に合わせて丸めますか？

いいえ。乗算結果を直接返します。通貨、元帳、決済事業者、契約で求められる丸め規則を別途適用してください。

負の金額も換算できますか？

はい。為替レートが正数であれば、貸方、返金、取消、同様の会計処理に負の金額を使用できます。

為替レートがゼロまたは負数の場合はどうなりますか？

為替レートはゼロより大きい有限数である必要があるため、無効な入力エラーになります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/calc2/currency-convert-static

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

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

curl -X POST https://api.kit.forhosting.com/calc2/currency-convert-static \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":125.5,"source_currency":"USD","target_currency":"EUR","exchange_rate":0.92}'

const res = await fetch("https://api.kit.forhosting.com/calc2/currency-convert-static", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount": 125.5,
    "source_currency": "USD",
    "target_currency": "EUR",
    "exchange_rate": 0.92
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/calc2/currency-convert-static",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "amount": 125.5,
    "source_currency": "USD",
    "target_currency": "EUR",
    "exchange_rate": 0.92
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/calc2/currency-convert-static", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"amount":125.5,"source_currency":"USD","target_currency":"EUR","exchange_rate":0.92}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"amount":125.5,"source_currency":"USD","target_currency":"EUR","exchange_rate":0.92}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/calc2/currency-convert-static", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "amount": 125.5,
  "source_currency": "USD",
  "target_currency": "EUR",
  "exchange_rate": 0.92
}

レスポンス例

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

技術的な注記

現在または過去の市場レートは取得しないため、結果にはリクエストで与えたレートがそのまま反映されます。

結果の計算方法を正確に確認できます

同じ JSON 入力からは、ネットワーク、時刻、乱数、変動する市場データに依存せず、同じ JSON 出力が得られます。

再現可能な処理には固定レートが適しています

自動化に利用する API は1リクエスト $0.002 です。

技術的な質問

API での換算料金はいくらですか。

API は1リクエスト $0.002 です。簡単な手動確認には、ブラウザーでも同じ決定的な計算を実行できます。

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

指定為替レートで通貨を換算

無料で実行

計算例

為替レートの向きを正しく指定します

結果の計算方法を正確に確認できます

再現可能な処理には固定レートが適しています

活用例

決済明細を照合します

固定レートで請求額を換算します

金融ソフトウェアをテストします

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

結果の計算方法を正確に確認できます

再現可能な処理には固定レートが適しています

技術的な質問

ありがとう