obol

obol

渡し守に支払いましょう。x402 を介した Solana エージェントゲートウェイです。

Obol は、AI エージェント向けの Solana 従量課金 API です。API キーもサブスクリプションも不要です。x402 payment protocol を使い、エージェントはリクエストごとに USDC で支払います。Solana の取引コストが 1 セント未満であるため、初めてマイクロペイメントが実用可能になりました。

名前の由来は、死者の舌の上に置かれ、冥界の川ステュクスを渡るためにカロンへ支払われた硬貨です。マイクロペイメントの原型です。

仕組み

1. エージェントが有料エンドポイントにデータをリクエストします
2. Obol が支払い要件（金額、受取人、ネットワーク）を含む HTTP 402 を返します
3. エージェントが要件に沿って Solana 上で USDC を送金します
4. エージェントが X-PAYMENT ヘッダーに取引証明を含めて再試行します
5. Obol がオンチェーンで検証し、データを返します

アカウントも、トークンも、オンボーディングも不要です。支払って使うだけです。

エンドポイント

ウォレット分析

エンドポイント	価格	説明
GET /api/v1/wallet/:addr/overview	$0.01	SOL 残高、トークン数、合計価値
GET /api/v1/wallet/:addr/portfolio	$0.05	価格、NFT、内訳を含む全保有資産
GET /api/v1/wallet/:addr/activity	$0.05	カテゴリー分類付き取引履歴
GET /api/v1/wallet/:addr/risk	$0.10	多要素リスク評価
GET /api/v1/wallet/:addr/pnl	$0.15	トークンのフロー分析、現在価値、損益

トークンデータ

エンドポイント	価格	説明
GET /api/v1/token/:mint/price	$0.005	Jupiter 経由のリアルタイム価格
GET /api/v1/token/:mint/metadata	$0.01	名前、シンボル、供給量、小数点以下の桁数

DeFi

エンドポイント	価格	説明
GET /api/v1/defi/swap/quote	$0.005	ルート計画付き Jupiter スワップ見積もり
POST /api/v1/defi/swap/execute	$0.25	Jupiter スワップ取引ビルダー
GET /api/v1/defi/positions/:addr	$0.10	DeFi ポジション — LST、LP、レンディング
GET /api/v1/defi/lst/yields	$0.02	Solana 上の LST 利回り比較

無料

エンドポイント	説明
GET /	API 情報と価格
GET /health	サービスの状態
POST /api/v1/rpc	Helius RPC プロキシ（許可リストに登録されたメソッド）

エージェントの例

完全なリファレンス実装については examples/agent-client.ts を参照してください。主な流れは次のとおりです。

import { ObolAgent } from './examples/agent-client';

const agent = new ObolAgent();
await agent.discover();  // fetch pricing
agent.loadWallet(process.env.AGENT_PRIVATE_KEY);

// Auto-discovers price, pays, and returns data
const price = await agent.fetch('/api/v1/token/USDC_MINT/price');

ウォレットなしで検出のみのモードを実行します：

npx tsx examples/agent-client.ts

MCP サーバー

Obol は MCP サーバーとして提供されています。Model Context Protocol に対応する AI エージェントであれば、Obol のツールをネイティブに検出して呼び出せます。

npm からインストール

npm install -g obol-mcp

Claude Desktop / Claude Code

MCP 設定に追加します：

{
  "mcpServers": {
    "obol": {
      "command": "npx",
      "args": ["-y", "obol-mcp"],
      "env": {
        "OBOL_URL": "https://obol-production.up.railway.app"
      }
    }
  }
}

または、ローカルで開発する場合：

{
  "mcpServers": {
    "obol": {
      "command": "npx",
      "args": ["tsx", "/path/to/obol/src/mcp.ts"],
      "env": {
        "OBOL_URL": "http://localhost:3000"
      }
    }
  }
}

利用可能な MCP ツール

ツール	説明
obol_wallet_overview	SOL 残高、トークン数、合計価値
obol_wallet_portfolio	価格と内訳を含む全保有資産
obol_wallet_activity	カテゴリー分類付き取引履歴
obol_wallet_risk	多要素リスク評価
obol_wallet_pnl	トークンのフロー分析と損益
obol_token_price	Jupiter 経由のリアルタイム価格
obol_token_metadata	名前、シンボル、供給量、小数点以下の桁数
obol_swap_quote	ルーティング機能付き Jupiter スワップ見積もり
obol_swap_execute	署名用スワップ取引の構築
obol_defi_positions	LST、LP、レンディングのポジション
obol_lst_yields	LST 利回り比較
obol_health	API ヘルスチェック（無料）
obol_info	エンドポイントの価格と情報（無料）

ローカルで実行

npm run mcp

技術スタック

• Fastify 5 — 高性能 HTTP
• @x402/svm — Solana 用の公式 x402 SDK
• Helius — RPC + DAS API
• Jupiter — トークン価格 + スワップ実行
• Upstash Redis — キャッシュ + 支払いレシート
• TypeScript — 完全な型安全性
• Zod — 実行時検証

セットアップ

git clone https://github.com/halfkey/obol.git
cd obol
npm install
cp .env.example .env
# Edit .env with your Helius key and merchant wallet address
npm run dev

テスト

# Unit + integration tests (46 tests)
npm test -- --run

# Smoke test against live deployment
npx tsx scripts/smoke-test.ts https://obol-production.up.railway.app

# Manual payment test
npx tsx scripts/test-payment.ts <tx-signature>

環境

.env.example を参照してください。主な変数は次のとおりです。

• PAYMENT_MODE — mock（開発用、自動承認）または onchain（本番用）
• PAYMENT_RECIPIENT_ADDRESS — USDC を受け取る Solana ウォレット
• HELIUS_API_KEY — Helius RPC へのアクセス
• UPSTASH_REDIS_REST_URL / TOKEN — キャッシュレイヤー

ロードマップ

• 11 個の有料エンドポイント（ウォレット、トークン、DeFi、LST、損益）
• リプレイ防止機能を備えたオンチェーン USDC 検証
• テストスイート（vitest 46 件 + 20 項目のスモークテスト）
• エージェントクライアントのリファレンス実装
• GitHub Actions CI
• ウォレット監視用の WebSocket サブスクリプション
• 混雑状況に基づく動的な料金設定
• マルチチェーン対応

ライセンス

MIT