ForHosting KIT · 開発者向けツール

共通通貨からクロス為替レートを計算

クロス為替レートは、同じ第三通貨に対してそれぞれ提示された2つの通貨を結び付けるレートです。基準通貨と決済通貨のコード、共通通貨を入力し、各通貨1単位が共通通貨の何単位に相当するかをご指定ください。互換性のある2つの提示値を割り、基準通貨1単位当たりの決済通貨の単位数と、その逆レートを算出します。通貨コードを検証し、除算の前にゼロのレートを拒否します。APIによる自動処理は、1リクエストにつき$0.002です。

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

無料で実行 API仕様を見る

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

2つの入力レートを同じ向きでお読みください

信頼できるクロス計算には、まずレートの向きをそろえる必要があります。この計算機では、2つのレートを「指定通貨1単位当たりの共通通貨の単位数」という同じ方式で入力します。たとえば、基準通貨がEUR、決済通貨がGBP、共通通貨がUSDの場合、base_rateはEUR当たりのUSD、quote_rateはGBP当たりのUSDを意味します。一方をEUR当たりのUSD、もう一方をUSD当たりのGBPとして入力しないでください。向きが反対のため、そのまま割ることはできません。通貨コードは大文字に正規化されますが、必ず3文字の英字である必要があります。共通通貨は交換対象の2通貨と異なり、基準通貨と決済通貨も互いに異なる必要があります。この規則により、cross_rateは常に基準通貨1単位当たりの決済通貨、inverse_rateはその逆を示します。計算前に各レートへ単位を添えると、分母が一致して互換性があるか確認できます。

除算と逆レートの仕組みをご確認ください

両方の提示値で共通通貨が分子にある場合、除算によってその単位が相殺されます。この計算機はbase_rateをquote_rateで割ります。1 EURが1.08 USD、1 GBPが1.26 USDなら、EUR当たり1.08 USDをGBP当たり1.26 USDで割るとUSDが消え、EUR当たりのGBPが残ります。逆レートはquote_rateをbase_rateで割って別に求め、GBP当たりのEURを返します。両方向を示すことで、請求書、元帳、表計算で正しいレートを逆向きに適用するという一般的なミスを防ぎやすくなります。出力の数式文字列には通貨の順序が記録されるため、数値をコピーしても意味を確認できます。丸めはJSON出力を安定させる有効桁の表現にのみ使用し、市場固有の表示精度は定めません。決済や会計では、数学的なクロスレートを得た後に、ご利用の機関が定める小数桁と丸めの規則を適用してください。

結果を使う前に元データをご検証ください

クロスレートの鮮度と信頼性は、元になる2つの提示レートに左右されます。この機能はネットワークへアクセスせず、入力値がリアルタイムの市場価格であるとも保証しません。金融処理に利用する場合は、同じ提供元、評価時刻、市場慣行、レート区分の値をご使用ください。小売向け売値と銀行間の仲値を組み合わせると、計算上は正しくても商取引上は誤解を招くレートになる可能性があります。両方の値はゼロより大きい有限の数でなければなりません。ゼロには専用の入力エラーを返し、負数や数値でない値も拒否します。決定論的な計算なので、同じJSON入力からは常に同じJSON出力が得られます。監査が必要な場合は、元の2レート、情報源、時刻を結果と共に保存してください。また、スプレッド、手数料、流動性、最小取引額、丸めの影響により、理論値は実際に取引できる提示値と異なることがあります。これらは本計算機の対象外です。

活用例

表計算でクロスレートを作成する

2つの通貨について、同じ共通通貨に対する互換性のある提示値が表にある場合、その通貨間レートを確認できます。

複数通貨の記録を照合する

同じ報告通貨のレート表から取得した帳簿価額を比較するため、一貫した換算係数を算出できます。

提示された換算レートを検証する

スプレッドや手数料を考慮する前に、業者またはシステムのクロスレートを2つの提示値から導かれる理論値と比較できます。

よくある質問

APIリクエストの料金はいくらですか？

APIリクエスト1回の料金は$0.002です。対応する無料利用では、ブラウザー上でも計算できます。

レートはどの向きで入力しますか？

どちらも、対応する基準通貨または決済通貨1単位当たりの共通通貨の単位数として入力してください。

ゼロのレートが拒否されるのはなぜですか？

ゼロの為替レートはこの計算では意味を持たず、一方の向きでゼロ除算が必要になるためです。

リアルタイムの為替価格を取得しますか？

いいえ。ご入力のレートだけを使用し、ネットワークへのリクエストは行いません。

cross_rateは何を意味しますか？

基準通貨1単位に相当する決済通貨の単位数を表します。

手数料や売買スプレッドは含まれますか？

いいえ。結果は入力値から導く算術上のクロスレートです。提供元の手数料、スプレッド、決済規則は別途扱います。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/econ/cross-exchange-rate

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

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

curl -X POST https://api.kit.forhosting.com/econ/cross-exchange-rate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_currency":"EUR","quote_currency":"GBP","common_currency":"USD","base_rate":1.08,"quote_rate":1.26}'

const res = await fetch("https://api.kit.forhosting.com/econ/cross-exchange-rate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "base_currency": "EUR",
    "quote_currency": "GBP",
    "common_currency": "USD",
    "base_rate": 1.08,
    "quote_rate": 1.26
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/econ/cross-exchange-rate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "base_currency": "EUR",
    "quote_currency": "GBP",
    "common_currency": "USD",
    "base_rate": 1.08,
    "quote_rate": 1.26
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/econ/cross-exchange-rate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"base_currency":"EUR","quote_currency":"GBP","common_currency":"USD","base_rate":1.08,"quote_rate":1.26}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"base_currency":"EUR","quote_currency":"GBP","common_currency":"USD","base_rate":1.08,"quote_rate":1.26}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/econ/cross-exchange-rate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "base_currency": "EUR",
  "quote_currency": "GBP",
  "common_currency": "USD",
  "base_rate": 1.08,
  "quote_rate": 1.26
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.cross_exchange_rate",
  "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の完全なドキュメントを見る →