Agent Financial Advisor

エージェント向け金融アドバイザー

取引や助言を行うAIエージェントのためのコンプライアンス担当者、リスクマネージャー、税務アドバイザー、パフォーマンス監査担当者です。 エージェントは行動を起こす前に呼び出し、根拠に基づく決定論的なチェックを受け、呼び出しごとに少額の料金を支払います。

ツール

ツール	価格	内容
rules_digest	無料	現行の米国の取引／証拠金／決済／税務ルール。有効日と出典を記載
pre_trade_check	$0.005	購買余力、現金口座の違反、日中証拠金（PDT廃止後）、Reg SHO、ウォッシュセール、集中度、ストップまでのリスク、流動性、スプレッド、誤発注、レバレッジ、市場の取引時間
position_size	$0.005	上限付きの固定比率法、ボラティリティ目標法、または分数ケリー法によるポジションサイズ算出
tax_lot_plan	$0.02	FIFO／LIFO／HIFO／最小税額となるロット選択、短期／長期の区分、ウォッシュセール、損失確定のスキャン
portfolio_review	$0.05	ウェイト、HHI、セクター／資産クラスのエクスポージャー、リバランス取引、シャープレシオ／ソルティノレシオ／ドローダウン／VaR／ベータ
strategy_audit	$0.10	取引統計、t統計量、確率的シャープレシオとデフレート・シャープレシオ、過剰適合の危険信号
suitability_check	$0.03	ハッシュ化された監査メモ付きのReg BI／受託者責任に基づく適合性レビュー
options_risk_check	$0.01	カバード／キャッシュ担保型／スプレッド／ネイキッドの分類、FINRA 4210の証拠金、現金口座の制限、承認レベル、配当前の早期割り当て、ピンリスク、自動権利行使、最大損失、ネット・グリークス

すぐに使えるコード（Alpaca注文ガード、MCPクライアント設定、x402決済クライアント）：examples/。

ローカルで実行（Node 20+、依存関係なし）

npm test
npm start         # http://localhost:8787  (payments off until PAY_TO is set)

お試しください：

curl localhost:8787/llms.txt
curl -X POST localhost:8787/v1/tools/position_size -H "content-type: application/json" \
  -d '{"equity":50000,"entry_price":100,"stop_price":95,"method":"fixed_fractional"}'

MCPクライアント：ストリーミング可能なHTTP MCP接続の接続先をhttp://localhost:8787/mcpに設定します。 キー付き無料プランとクレジットを利用するには、Authorization: Bearer <key>を送信するか、/mcp?key=<key>を使用するか、エージェントから無料のget_api_keyツールを呼び出します。このツールは新しいキーをMCPセッションに紐付けます。任意のURLに?src=<name>を追加すると、/statsで使用状況を集計できます。

エンドポイント

メソッド	パス
GET	/, /llms.txt	エージェントが読み取れる概要
GET	/v1/tools, /openapi.json, /pricing, /.well-known/x402	検出
POST	/v1/tools/{name}	ツールを実行
POST	/mcp	MCP JSON-RPC
POST	/v1/keys	無料APIキー
GET	/v1/keys/me	キー残高
POST	/v1/credits?pack=5|20|100	x402でクレジットを購入
GET	/v1/audit	改ざんを検知できる監査ログ：キーを使った有料呼び出しをすべて記録。ハッシュチェーン化し、サーバーが署名（?since_seq=）
POST	/v1/audit/verify	監査エントリーのハッシュ、署名、チェーンを検証
GET	/stats	公開集計使用状況：呼び出し数、有料呼び出し数、発行済みキー数、収益（個人を特定する情報なし。10分間キャッシュ）
GET	/admin/revenue	収益と使用状況（ADMIN_TOKEN）

設定（環境変数）

変数	デフォルト
PAY_TO	未設定	USDCの受取アドレス。未設定の場合は無料プレビューとなり、決済は行われません
X402_NETWORK	base-sepolia	実際の資金を使用する場合はbase
CDP_API_KEY_JSON	未設定	シークレット：ダウンロードしたCDPキーファイル。設定すると、決済はCoinbase CDPファシリテーター経由になります（メインネットに必要）。CDP_API_KEY_IDとCDP_API_KEY_SECRETも使用できます
FACILITATOR_URL	キー設定時はCDP、それ以外はhttps://x402.org/facilitator	ファシリテーターを上書き
FACILITATOR_AUTH	未設定	CDP以外のファシリテーター用の静的Authorizationヘッダー
X402_MIN_USD	0.01	x402の呼び出しごとの最低料金（クレジット利用時は表示価格を適用）
FREE_DAILY_CALLS / FREE_DAILY_ANON	25 / 5	無料プラン
ADMIN_TOKEN	未設定	/admin/revenue用
DATA_DIR	./data	Nodeのストアと台帳
PUBLIC_URL	リクエストホスト	決済要件で使用

デプロイ（無料）

Cloudflare Workers：npx wrangler kv namespace create AFA_KVを実行し、IDをwrangler.tomlに記載してから、npx wrangler deployを実行します。

実際のUSDCを使用する場合：npx wrangler secret put CDP_API_KEY_JSON < secrets/cdp_api_key.jsonを実行し、wrangler.tomlでX402_NETWORK = "base"を設定してデプロイします。

決済（x402）

x402 v2 に対応しています。402 では、base64 エンコードされた PAYMENT-REQUIRED ヘッダー（CAIP-2 ネットワーク。例：eip155:8453）が送信され、クライアントは PAYMENT-SIGNATURE で支払い、決済結果は PAYMENT-RESPONSE で返されます。v1 クライアント（X-PAYMENT、本文の accepts）も引き続き動作します。

テストネットでのエンドツーエンドテスト：npm i --no-save viem && node scripts/e2e-payment.mjs <server url> --fund

レイアウト

src/app.js            fetch-style router: REST, MCP, billing hooks
src/server.js         Node entry
src/worker.js         Cloudflare Workers entry (KV store)
src/billing/          free tier, API keys, credits, x402, ledger
src/tools/            the advisory tools
src/lib/regs.js       rule table with sources (reviewed weekly)
src/lib/calendar.js   NYSE calendar
test/                 node --test suites