Baron Power Play

Baron Power Play

自律型エージェント向けの従量課金制 AI インフラです。USDC を Base 上で支払い、Coinbase が決済します。API キーもアカウントもサブスクリプションも不要です。

ベース URL：https://baron-power-play.baronpowerplay.workers.dev

---

なぜこれが必要なのか

エージェントが有料 API の利用で失敗する原因は、予測可能なものが 4 つあります。Baron Power Play は、それぞれを解消するために構築されています。

エージェントの失敗	Baron の対策
料金やサービスの仕様がわからないまま、支払いを決めなければならない	すべてのルートで、正確な x402 v2 チャレンジと、機械可読な契約を公開しています。リクエストを 1 件でも送信する前に、料金を小数点以下 6 桁まで確認できます。
タスクの途中でプロバイダーが 429 を返し、エージェントが停止する	複数の独立したエンジンを自動フェイルオーバーと日次共有容量で運用しています。エンジンが停止しても、呼び出し元には影響しません。
サードパーティーサービスが、応答に紛れ込ませたテキストでエージェントを誘導できる	プロンプト上書きの試みは支払い前にブロックし、モデルの出力は返却前にスキャンします。

エージェントの場合は、まず /.well-known/x402.json と /openapi.json をお読みください。 これらが契約です。この README は、人間向けの概要です。

---

支払い前に確認する

これは無料で、当サービスを利用するかどうかを判断する最も早い方法です。

curl https://baron-power-play.baronpowerplay.workers.dev/test

エンジンごとの稼働状況、ライブ推論の結果、市場データと音声の各経路のライブチェックが返されます。登録時に一度実行するだけでなく、このサービスに依存する前に毎回実行してください。

---

サービス

エンドポイント	メソッド	料金（USDC）	内容
/infer	POST	0.001	LLM 推論です。JSON とコードは出力時に自動でフォーマットされます。
/markets	GET	0.002	DeFi の TVL 上位銘柄、DEX のトレンドペア、ミームカテゴリ、ウォッチリスト、差分同期です。
/alpha	GET	0.05	ケリー基準によるポジションサイジングを含むトレードメモです。検証済みの実績は公開されていません。トレードのシグナルではなく、調査用の情報として扱ってください。
/tts	POST	0.01	感情表現付きのテキスト読み上げです。ウォレットごとに記憶される発音辞書も利用できます。
/stt	POST	0.01	暗号資産キーワードの検出とタイムスタンプ付きセグメントに対応した音声テキスト変換です。
/test	GET	無料	準備状況、エンジンの稼働状況、ライブの機能チェックです。

/alpha はクエリパラメーターとして portfolio_size_usd を受け付けます。

---

支払い

• ネットワーク： Base（eip155:8453）
• 資産： EIP-3009 の transferWithAuthorization で支払う USDC
• 資産の識別情報： USD Coin バージョン 2
• プロトコル： x402 v2 — HTTP 402 Payment Required
• ファシリテーター： Coinbase CDP（https://api.cdp.coinbase.com/platform/v2/x402）
• 受取ウォレット： 0xb838930bf3dFD467D30979E12c0a94286F86708D

フローは標準的なものです。リクエストを送信すると、正確な支払い要件とともに 402 が返されます。認証に署名し、PAYMENT-SIGNATURE ヘッダーを付けて再送すると、ファシリテーターが Base 上で決済します。Coinbase が支払いを検証して決済した後にのみ、処理を実行します。 未払いの処理は一切行いません。

通信上の金額はトークンの最小単位です。0.001 USDC の呼び出しは、accepts[].amount で 1000 として提示されます。openapi.json の amount フィールドは USD の小数表記ですが、実行時の accepts[].amount は最小単位です。

---

容量

推論は、複数の独立したエンジンで容量を共有し、残り容量に応じてエンジンを選択します。自動フェイルオーバーにより、上流の障害は呼び出し元に影響しません。

容量は 00:00 UTC にリセットされます。共有プールの容量が尽きると、汎用的なエラーではなく、Retry-After と再利用を促す案内を含む、機械可読な SOLD_OUT をルートが返します。

/markets、/alpha、/tts、/stt は LLM エンジンプールの容量を消費しません。

---

利用制限と不正利用対策

ウォレットごと、1 日あたり：

• エンドポイントごとに 50 回（/alpha は 20 回）
• ウォレットの最初の 24 時間は、さらに低い上限
• 合計利用額 $10
• 1 秒あたり 10 件の支払いリクエスト

リクエストごと：

• User-Agent が必須です。3 文字以上にしてください
• POST では Content-Type: application/json を送信する必要があります
• 1 MB を超える本文は拒否されます
• 2000 文字を超えるクエリー文字列は拒否されます
• X-Idempotency-Key は任意です。最大 128 文字で、使用できる文字が制限されています
• HTTP メソッドが正しくない場合は、機械可読な METHOD_NOT_ALLOWED を含む 405 が返されます

再利用対策：

• 使用済みの支払いヘッダーは 1 時間拒否されます
• 使用済みの USDC 認証ノンスは 24 時間拒否されます
• 1 時間に 5 回、オーバーライドが拒否されると、そのウォレットは 1 日間ブロックされます

すべてのエラーは同じ形式を使用するため、説明文を解析する代わりに code に応じて処理できます：

{
  "error": "/infer accepts POST, not GET",
  "code": "METHOD_NOT_ALLOWED",
  "suggestion": "Use POST /infer.",
  "timestamp": 1790458945409
}

---

紹介

ウォレットを紹介すると、双方にメリットがあります。紹介されたウォレットは最初の有料呼び出しが 10% 割引になり、紹介者には決済後に定価の 5% が付与されます。紹介による呼び出しは 1 日あたり最大 3 回で、自分自身を紹介することはできません。

---

探索

• GET /openapi.json — リクエストとレスポンスのスキーマ、ルートごとの x-payment-info、エラーコードを含む標準の OpenAPI 3.1 コントラクト
• GET /.well-known/x402.json — エンドポイント、価格、メソッド、ファシリテーター、支払い要件、防御策を含む x402 マニフェスト
• GET /test — 無料の稼働状況と処理能力のチェック

---

使用方法

BASE=https://baron-power-play.baronpowerplay.workers.dev

# free readiness check
curl -s "$BASE/test"

# the machine-readable contract
curl -s "$BASE/openapi.json"

# see the exact payment requirement before paying anything
curl -si -X POST "$BASE/infer" \
  -H 'Content-Type: application/json' \
  -H 'User-Agent: your-agent/1.0' \
  -d '{"messages":[{"role":"user","content":"hello"}]}'
# -> HTTP 402 with the x402 v2 challenge in accepts[]

# market data
curl -s "$BASE/markets"

有料の呼び出しを行うには、402 レスポンスの accepts[] エントリーを取得し、ウォレットで対応する EIP-3009 認証に署名して、元のリクエストを PAYMENT-SIGNATURE ヘッダーとともに再送信します。x402 v2 クライアントライブラリを使えば、これらの処理をすべて実行できます。

---

ライセンス

まだ宣言されていません。再利用可能なものとして扱う前に、LICENSE ファイルを追加してください。