通貨両替金額計算機

検証失敗は課金されず、成功した呼び出しは公開されている $0.002 の基本料金が 1 件あたりに適用されます。

上乗せと手数料を含む換算式の仕組み

任意の markup_percent は両替所やカード発行体のようにレートを広げます。effective_rate は rate に 1 プラス markup_percent を 100 で割った値を掛けたものです。総換算額は amount に effective_rate を掛けた値です。任意の fee_percent は元の現金ではなくその総額に掛かります。fee_amount は gross に fee_percent を 100 で割った値を掛けたもの、net_converted は gross から fee を引いたものです。amount は非負、rate は厳密に 0 より大、fee_percent は 0 以上 100 以下、markup_percent は非負です。任意の from_currency と to_currency ラベルは表示用に返すだけで、ライブ価格は決して取得しません。

入力契約、応答フィールド、エラー挙動

任意の precision は 0 から 15 の整数です。必須の有限数 amount と rate を含む JSON 本体を POST してください。JSON 数値でも単純な小数文字列でも送れます。空文字、Infinity、NaN はフィールド名付きの invalid_input で失敗します。任意の fee_percent は省略時 0、markup_percent も同様です。任意の from_currency と to_currency は最大 32 文字の自由ラベルで、レポートの一貫性のために USD や EUR のような ISO 4217 コードを使えますが、ソルバーは通貨レジストリを検証しません。成功時の本体は amount、rate、fee_percent、markup_percent（丸め済み）に加え、effective_rate、gross_converted、fee_amount、net_converted、precision、安定した formula 文字列、method user_rate_markup_fee を返します。通貨ラベルは指定した場合にのみ現れ、任意フィールドは null ではなく省略されます。例：amount 1000、rate 0.92、markup 2、fee 1.5 のとき、小数第 2 位精度で effective_rate は 0.9384、総額は 938.40、手数料は約 14.08、正味は約 924.32 になります。負の amount、正でない rate、0–100 外の fee、負の markup は invalid_input となり課金されません。

ユーザー指定レートの FX 計算機が役立つ場面

企業の出張デスクは、レートが既知のとき有料の市場データ契約なしに API 経由で数十行の日当を $0.002 の成功課金でバッチ処理できます。実際にどれだけ手数料を払っているか」という教育記事では amount と rate を固定し fee_percent を走査して正味曲線を示し、市場ティックを捏造する必要はありません。リクエストを小さく保ち、テストで丸め出力を固定すれば、為替ベンダー契約なしでアプリ、LMS デモ、エッジワーカー向けに再現可能な換算算術が得られます。