APIの価格設定

価格設定の考え方 — 何を請求するか、satsがドルにどう換算されるか、さまざまなユースケースに対する戦略。

Satoshi参照テーブル

1 sat = Bitcoinの1/100,000,000。一般的な価格帯での換算:

BTCの価格	1 sat	10 sats	100 sats	1,000 sats
$50,000	$0.0005	$0.005	$0.05	$0.50
$80,000	$0.0008	$0.008	$0.08	$0.80
$100,000	$0.001	$0.01	$0.10	$1.00

Lightning Networkの支払いには最低手数料がありません。1 satの支払いは送信者にとって約$0.0005のコストです — Stripeでは不可能な金額です（最低$0.30）。

---

ユースケース別の価格設定

ユースケース	推奨価格	理由
シンプルなデータクエリ（天気、為替レート）	1〜10 sats	無視できるほど安価でありながら、意味のある金額
プレミアムAPIコール（LLM推論、検索）	10〜100 sats	計算コストをカバーし、乱用を防ぐ
ドキュメント/ファイルへのアクセス	50〜500 sats	コンテンツの価値を反映
高価値レポートまたはデータセット	500〜5,000 sats	$0.50〜$5のマイクロトランザクションと競合
リアルタイムストリーミング（チャンクごと）	1〜5 sats	ストリーム全体で自然に蓄積される

これらは出発点です。適切な価格とは、呼び出し元がストレスなく支払える金額です。

---

低価格から始めて引き上げる

価格の変更はコード1行で済むため、ローンチ時は低価格に設定することをお勧めします:

l402({ priceSats: 10, lightning }) // ここから始める
l402({ priceSats: 100, lightning }) // 需要が続けば引き上げる

VS Codeダッシュボードの支払いデータで呼び出し量と収益を確認し、価格の調整に活用してください。

---

大規模利用時のManaged vs Soberano

0.3%のManaged手数料は大量取引時にのみ影響します:

月間取引量	Managed手数料	Soberanoによる節約
1,000 sats	3 sats	無視できる
100,000 sats	300 sats（約$0.24）	小さい
10,000,000 sats	30,000 sats（約$24）	切り替える価値あり

目安: 月間処理量が1M sats未満（$80k/BTCで約$800）であれば、0.3%の手数料は誤差の範囲内です。Managedを使いながら開発に集中しましょう。取引量が増えたタイミングでSoberanoに切り替えてください — コード1行で完了します。

---

AIエージェント向けの価格設定

エージェントは人間とは異なる意味で価格に鈍感です — 支払いの痛みを感じることはありませんが、オペレーターが設定した予算制限があります。

実践的なガイダンス:

• 一般的なエージェント用途では、1回のコールを100 sats未満に抑えてください — これは典型的なセッションごとの予算に収まります
• 高価値なエージェントツール（コード実行、ドキュメント分析）では、100〜1,000 satsが許容範囲です
• 入力サイズによってコストが変わる場合は、priceSatsを動的に使用してください:

app.post("/analyze", (req, res, next) => {
  const sats = Math.ceil(req.body.text.length / 100); // 1 sat per 100 chars
  l402({ priceSats: sats, lightning })(req, res, next);
}, handler);

---

複数エンドポイントによる段階的アクセス

異なるエンドポイントへのルーティングによって、価格帯を分けることができます:

// 無料プラン — 基本データ
app.get("/data/basic", handler);

// 有料プラン — 全データセット、10 sats
app.get("/data/premium", l402({ priceSats: 10, lightning }), handler);

// 高価値プラン — リアルタイムフィード、100 sats
app.get("/data/realtime", l402({ priceSats: 100, lightning }), handler);

各エンドポイントは独自のインボイスを生成します。呼び出し元はコールごとに支払います — サブスクリプション管理は不要です。

---

価格設定のテスト

公開前に、実際のウォレットで全支払いフローをテストしてください:

1. priceSats: 1を設定する（1 sat ≈ $0.0008 — 気軽にテストできる金額）
2. スマートフォンでWallet of SatoshiまたはBlinkを使用する
3. エンドポイントを呼び出し、インボイスのQRコードをスキャンして、200 OKを確認する
4. VS CodeダッシュボードまたはLightning Networkウォレットで受信を確認する

確認が取れたら、実際の価格を設定してデプロイしてください。