ForHosting KIT · 金融・お金

サトシ⇔ビットコイン換算

サトシとビットコインを、小数点を手で動かさずに換算します。100,000,000 satsはちょうど1 BTCです。リアルタイムの相場ではなく、ご自身で決めた1ビットコインの価格を入れると、保有額の評価も分かります。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

量: 100,000,000
開始: sats
BTC価格: 65,000

結果

サトシ: 100,000,000
Btc: 1
法定通貨での価値: 65,000
1BTCあたりのsats: 100,000,000

ビットコインの金額は取引所ではコイン単位、チェーン上・ウォレット・Lightning請求書ではサトシで示されることが多くあります。1ビットコインは定義上ちょうど1億サトシであり、両単位の変換は純粋な算術です。それでも小数点を手で8桁ずらしたり、誤った市場の価格を貼り付けたりすると誤りが起きがちです。本サトシ⇔ビットコイン換算は金額・単位（satsまたはbtc）・お客様が指定する1BTCの法定通貨価格を受け取り、サトシ・ビットコイン・その保有の法定通貨価値を返します。ライブ価格フィードも外向き通信もありません。

サトシ・ビットコイン・法定通貨価値の関係

市場価格は別の数です。関心の法定通貨（米ドル、ユーロなど）を、関心が関心する時点でフル1BTCに何単位割り当てるかです。ビットコイン数量にその価格を掛けると保有の法定通貨価値になります。両者を分けることは簿記と教育の両方で重要です。

在庫台帳・手数料見積・UTXOツールは整数サトシで考え、チェーン上に存在し得ない端数サトシを作りません。会計・税務シート・ポートフォリオ画面は法定通貨で考え、ビットコインを現金・給与・他資産と比較します。本機能は1回の呼び出しで両方を行います。

活用例

ウォレット残高の二重表示

整数のサトシ残高をUIラベル用にBTCへ変換し、保存済みの時価評価価格を掛けて法定通貨合計を求めます。

授業での単位換算ドリル

satsをBTCに直し、指定の試験価格で保有を評価する宿題を決定的に照合します。

よくある質問

1ビットコインには何サトシありますか？

定義によりちょうど100,000,000サトシが1 BTCです。本換算は常にその固定係数を使い、市場価格は単位比を変えません。

結果はどう丸められますか？

サトシは最も近い整数へhalf-up。ビットコインは小数第8位までhalf-up。法定通貨価値は通貨表示向けに小数第2位までhalf-upです。

リアルタイムのビットコイン価格を使いますか？

いいえ。1ビットコインの価格は、好きな通貨で、年末の終値や平均取得価格など必要な時点の値をご自身で入力します。そのため、結果を何度でも再現できます。

サトシではなくビットコインで数量を入力できますか？

はい。入力する数量の単位として、ビットコインかサトシを選べます。両方の単位での数量と、入力した価格での評価額が表示されるので、どちらからでも計算できます。

手持ちのサトシが自国通貨でいくらになるか知るには？

サトシの数量と、その通貨での1ビットコインの価格を入力します。サトシをビットコインに換算して価格を掛け、評価額を小数点以下2桁に丸めて表示します。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/finance/satoshi-to-btc

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

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

curl -X POST https://api.kit.forhosting.com/finance/satoshi-to-btc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":100000000,"from":"sats","btc_price":65000}'

const res = await fetch("https://api.kit.forhosting.com/finance/satoshi-to-btc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "amount": 100000000,
    "from": "sats",
    "btc_price": 65000
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/finance/satoshi-to-btc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "amount": 100000000,
    "from": "sats",
    "btc_price": 65000
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/finance/satoshi-to-btc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"amount":100000000,"from":"sats","btc_price":65000}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"amount":100000000,"from":"sats","btc_price":65000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/finance/satoshi-to-btc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "amount": 100000000,
  "from": "sats",
  "btc_price": 65000
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "finance.satoshi_to_btc",
  "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で失敗し、課金されません。

サトシ・ビットコイン・法定通貨価値の関係

サトシはBitcoinネットワークで一般に使われる最小単位であり、定義により1ビットコインにはちょうど1億サトシが含まれます（1 BTC = 100,000,000 sats）。この比率は市場価格では変わらず、セントとドルのような単位変換であって評価そのものではありません。固定の1億倍係数で入力金額をサトシとビットコインに正規化し、ご指定のbtc_priceを掛けて小数第2位までhalf-upしたfiat_valueを出します。

入力契約・単位・丸めと計算例

fromはsats（別名sat、satoshi、satoshis）またはbtc（別名bitcoin）で、大文字小文字は区別しません。通貨コード欄はありません。ラベルはご自身のUIで管理してください。必須3フィールドのJSON本体をPOSTしてください。amountはfromで示す単位での保有量を表す非負の有限数（または数値文字列）です。btc_priceは0より大きい有限数で、レポートに使う通貨でのフル1BTCの法定通貨価格です。成功時はamount・from・btc_priceをエコーし、satoshisをhalf-up整数、btcを8桁までhalf-up（ビットコインの慣例表示精度）、fiat_valueを2桁half-up、sats_per_btcを100000000固定、恒等式を示す短いformula文字列を返します。例：amount 1億、from sats、btc_price 65000なら1BTC・1億サトシ・法定通貨価値65000。例：amount 0.5、from btc、btc_price 60000なら5千万サトシと法定通貨価値30000。例：amount 21000、from sats、btc_price 40000なら0.00021 BTCと小さな法定通貨額。欠落・空文字・負の金額・正でない価格・未知単位はinvalid_inputで問題を示して失敗し、課金されません。価格の単位はbtc_price設定時にお選びいただくものです。

法定通貨評価付きsats⇔BTC換算が役立つ場面

教育者やLMSは単位換算ドリル用の決定的オラクルを必要とし、提示された市場価格も掛けることで単位分析と評価の両方を練習できます。検証失敗は残高を消費しません。ウォレットやエクスプローラの画面は同じ残高をサトシとビットコインの両方で示すことが多く、小さな純粋換算を呼べばWeb・モバイル・APIクライアントで表示計算を揃え、8桁シフトを再実装せずに済みます。ポートフォリオや税務ツールは年次終値・平均取得原価・宿題の固定気配など、お客様が選んだ特定価格での法定通貨評価が必要で、リクエスト途中のライブティッカー値ではありません。実装は純粋parseのtier Aのため、成功した呼び出しはモデルトークンも外向き通信もなく公開の基準価格$0.002です。金額を非負に保ち、丸め後フィールドをテストで固定すれば、スプレッドシート・n8nフロー・エッジワーカー向けに再現可能なsats・BTC・法定通貨数値が得られ、ご自身で取引所連携を立てる必要はありません。

連携の活用例

税務・取得原価のワークシート

固定のsatまたはBTC金額を、ご指定の年末または平均取得原価のbtc_priceで評価します。オフラインかつ再現可能です。

技術的な質問

ライブのBitcoin価格は必要ですか？

不要です。btc_priceはお客様がご自身で指定します（スポット、取得原価、任意の法定通貨/BTC）。APIは市場データを取得しません。

双方向に換算できますか？

はい。fromをsats（またはsat/satoshi/satoshis）にするとサトシ起点、btc（またはbitcoin）にするとビットコイン起点です。どちらもsatoshis・btc・fiat_valueを返します。

サトシ⇔ビットコイン換算の料金は？

ブラウザツールは無料です。APIは成功した呼び出しごとに前払いKIT残高から$0.002です。無効入力は課金されません。

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

サトシ⇔ビットコイン換算

無料で実行

計算例

サトシ・ビットコイン・法定通貨価値の関係

活用例

ウォレット残高の二重表示

授業での単位換算ドリル

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

サトシ・ビットコイン・法定通貨価値の関係

入力契約・単位・丸めと計算例

法定通貨評価付きsats⇔BTC換算が役立つ場面

連携の活用例

税務・取得原価のワークシート

技術的な質問

ありがとう