tech-risk

Grey Ridge Signals — エージェントネイティブな x402 データ／セキュリティ API

x402 支払いプロトコルを使って Base メインネット上で提供する、AI エージェント向けの従量課金型暗号資産、DeFi、予測市場、オンチェーンデータ、および MCP セキュリティスキャンです。

アカウント、API キー、サブスクリプションは不要です。エージェントはリクエスト内で USDC（1 回あたり $0.001 から）を支払い、同じリクエストでデータを受け取ります。すべてのデータエンドポイントには無料プレビューがあり、支払い前にエージェントがデータを試せます。

• ベース URL： https://x402-data-api.sigrunner.workers.dev
• MCP エンドポイント（streamable-http）： https://x402-data-api.sigrunner.workers.dev/mcp
• 正規ドメイン： https://x402-data-api.sigrunner.workers.dev（同一 API）
• ディスカバリー： /.well-known/x402 · /openapi.json · /llms.txt
• ネットワーク： Base メインネット（eip155:8453）、USDC。ノンカストディアルの xpay ファシリテーター経由で決済されるため、Coinbase/CDP アカウントは不要です。CDP x402 Bazaar にも掲載されています。

---

2 つの主力機能 — エージェントが実際に料金を支払うもの

1. MCP サーバーのセキュリティスキャン（/scan/mcp、$0.05）— MCP サーバーのツールに対するプロンプトインジェクション／ツールポイズニング監査（OWASP LLM01/LLM08）です。ゼロエグレス：プライベートサーバーや OAuth 認証が必要なサーバーでは、tools/list の JSON のみを POST し、それ以外は一切こちら側から送信されません。これに相当する無料サービスはありません（無料のマルチチェーンスキャナーがあるトークン安全性チェックとは異なります）。無料プレビュー：POST /scan/mcp/preview。CI ゲート：uses: rezearcher/x402-data-api/actions/mcp-scan@main。
2. 取引前の意思決定ゲート（/gate/swap、$0.008 · /chain/token-report、$0.01）— エージェントが解釈する必要のある生のフラグではなく、取引規模に応じた判断結果（GO/HOLD/BLOCK、SAFE/CAUTION/AVOID）を返します。Base ネイティブです。他のチェーンで取引する場合は、マルチチェーンスキャナーを引き続き利用し、Base ではこの機能をお使いください。

以下は全カタログです（暗号資産／DeFi データ、オンチェーン読み取り、LLM、エンリッチメント）。実測の信頼性は /status で確認できます（SLA ではありません）。

---

エンドポイント

暗号資産・DeFi データ

エンドポイント	価格	戻り値
GET /crypto/prices?coins=bitcoin,ethereum,solana	$0.001	スポットトークン価格（DefiLlama）、キー不要。CoinGecko ID を最大 25 個指定できます。
GET /crypto/funding?limit=20	$0.001	複数取引所横断のパーペチュアル資金調達率（Hyperliquid + OKX、適切なフォールバック付き）と、資金調達率のスプレッドおよび最適なロング／ショート取引所 — 単一取引所の一覧ではなく、裁定取引のシグナルです。
GET /defi/yields?limit=20&project=&chain=&stable=	$0.001	DeFi のレンディング／LP 利回り上位（DefiLlama）。APY の内訳に加え、7 日／30 日の APY トレンド、IL リスク、DefiLlama の安定性予測を提供します。単なる一覧ではなく、意思決定に役立つ情報です。
GET /pm/markets?query=&limit=20	$0.005	Polymarket のライブ予測市場：質問、結果、価格、取引量、流動性、終了日。

Base オンチェーン（JSON-RPC 読み取りプリミティブ）

Base ネイティブのマルチプロバイダー RPC。自動フェイルオーバーに対応しており、1 つのプロバイダーのレート制限によって有料リクエストが失敗することはありません。

エンドポイント	価格	戻り値
GET /chain/block-number	$0.001	現在の Base ブロック番号
GET /chain/gas-price	$0.001	現在のガス価格（wei + gwei）
GET /chain/balance?address=	$0.001	ネイティブ ETH 残高
GET /chain/token-balance?address=&token=	$0.001	ERC-20 トークン残高
GET /chain/tx?hash=	$0.001	トランザクションの詳細
GET /chain/receipt?hash=	$0.001	トランザクションレシート（ステータス、使用ガス量、ログ）
GET /chain/code?address=	$0.001	コントラクトコードの確認 — コントラクトかどうか、および EIP-7702 委任 EOA の検出（is_eip7702_delegate / delegate_address）
GET /chain/wallet?address=	$0.003	一括取得： ETH 残高 + トランザクション数 + コントラクトフラグを 1 回の呼び出しで返します。EIP-7702 委任 EOA に対応しています（is_eip7702_delegate / delegate_address）

エージェント取引ゲート（新規）

エンドポイント	価格	内容
GET /gate/swap?token=0x…&side=buy|sell&notional_usd=N	$0.008	取引前の実行／保留／ブロック判定：あらゆる Base ERC-20 を対象に、安全性の判定、リスクスコア、プールの流動性と指定サイズによる価格への影響、フラグを返します。エージェントがスワップする前に行う 1 回の呼び出しです。無料のライブサンプル：/gate/swap/preview
GET /chain/token-report?token=0x…	/openapi.json を参照	トークンの完全なデューデリジェンスレポート（セキュリティ＋流動性＋メタデータ）を 1 回の呼び出しで返します

セキュリティ

エンドポイント	価格	内容
GET /scan/mcp?url=	$0.05	対象の MCP サーバーのセキュリティ監査：ツールポイズニング／プロンプトインジェクション／情報流出／危険な機能／隠し Unicode（OWASP LLM01/LLM08）＋リスクスコア
POST /scan/mcp {"tools":[…]}	$0.05	外部通信ゼロの監査 — 独自の tools/list 配列を貼り付けると、同じ項目別の検出結果を返します。データがこちらから外に出ることはなく、サーバーへの取得や呼び出しも行いません。URL を公開しない OAuth で保護された MCP サーバーやプライベート MCP サーバー向けです
GET /enrich/tech-risk?domain=	$0.05	技術スタックのフィンガープリント → CVE（NVD）＋ EPSS ＋ CISA-KEV の攻撃対象領域リスク
GET /enrich/domain?domain=	$0.01	企業情報＋技術スタックのエンリッチメント。crt.sh の証明書透明性ログ、RDAP、DoH、HTTP フィンガープリントによるすべてのサブドメインの列挙（subdomains[]）を含みます

無料のプレビュー：GET /crypto/prices/preview、/crypto/funding/preview、/defi/yields/preview、/chain/block-number/preview、/chain/gas-price/preview（省略されていない完全なライブデータ）、/scan/mcp/preview?url=。外部通信ゼロの MCP スキャン（プライベートまたは OAuth で保護されたサーバー向け）：{"tools":[…]} を指定した POST /scan/mcp/preview は無料の件数のみのプレビューです。同じ本文で POST /scan/mcp を呼び出すと、有料の項目別スキャンを実行します。データがこちらから外に出ることはありません。ワンライナー：examples/mcp-scan-preview.sh。

---

MCP サーバー（プルチャネル）

リモート MCP サーバーを 1 つ追加すると、エージェントはすべてのツールセットを利用できます。エージェントがツールを検出できるよう、initialize と tools/list は無料です。有料の tools/call は x402 チャレンジを返します。

tools/list は 22 個のツールを公開します：crypto_prices、crypto_funding、defi_yields、pm_markets、 chain_block_number、chain_gas_price、chain_balance、chain_token_balance、chain_tx、 chain_wallet、chain_token_security（有料の Base RPC ＋データ、EIP-7702 の委任 EOA に対応）、 crypto_prices_preview、crypto_funding_preview、defi_yields_preview、pm_markets_preview、 chain_block_number_preview、chain_gas_price_preview、chain_token_security_preview（無料）、 および scan_mcp_server、scan_mcp_preview、enrich_tech_risk、enrich_domain（セキュリティ）。

// add to your MCP client config
{
  "mcpServers": {
    "grey-ridge-x402": {
      "type": "streamable-http",
      "url": "https://x402-data-api.sigrunner.workers.dev/mcp"
    }
  }
}

MCP クライアント（mcp-client/ — stdio 用コンパニオン）

stdio のみをサポートする MCP クライアント（Claude Desktop、Cursor、CLI エージェント）向けに、リポジトリには コンパニオンパッケージ x402-data-api-mcp が mcp-client/ に含まれています。エージェント自身のマシン上で動作し、 stdio 経由で MCP を使用して、同じ Worker の /mcp エンドポイントにプロキシします。データの提供範囲は追加せず、 stdio のみのクライアントが同じツール（22 個のツール。ウォレットキーが設定されていれば有料ツールも含む）を利用できるように、 トランスポートと x402 決済の仲介機能だけを提供します。

インストール／実行（ローカルパス）。 パッケージはまだ npm に公開されていないため、リポジトリから実行してください：

cd mcp-client
npm install
npm run build          # tsc → dist/server.js
node dist/server.js    # start (or: npm start)

公開後の利用方法： npx x402-data-api-mcp（パッケージの bin ターゲットは dist/server.js なので、npx は同じサーバーを実行します）。

設定。 mcp-client/.env.example を mcp-client/ 内の .env にコピーします。WORKER_BASE_URL のデフォルト値はデプロイ済みの Worker です（独自のミラーを使用する場合にのみ変更します）。X402_WALLET_PRIVATE_KEY は任意です。設定すると、x402 経由で有料ツール（HTTP 402）の決済を自動で行います。空のままにすると、 無料／プレビューツールのみを実行します。クライアントは起動時に、どちらの値も process.env から直接読み込みます。

// stdio client config (local path)
{
  "mcpServers": {
    "grey-ridge-x402-local": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-client/dist/server.js"]
    }
  }
}

呼び出し（HTTP）

BASE=https://x402-data-api.sigrunner.workers.dev

# free preview — real sample, no payment
curl -s "$BASE/crypto/funding/preview"

# paid — returns HTTP 402 with an x402 payment-required challenge until you attach payment
curl -i "$BASE/crypto/funding?limit=10"

x402 に対応したクライアント（例：x402 ライブラリ）であれば、402 → 署名 → 再試行を自動的に処理します。

測定済みステータス

各安全性ルートの稼働時間とレイテンシは、プローブ用 cron で測定され、docs/STATUS.md に公開されます（1 時間ごとに再生成。対象期間はファイル内に記載されており、SLA ではありません）。

実行の仕組み

単一の Cloudflare Worker が、メソッドを考慮する x402 ゲートの背後で、すべての HTTP エンドポイントと MCP サーバーを実装しています。すべての上流 API は無料で、API キーも不要の公開 API（DefiLlama、Hyperliquid、OKX、Polymarket Gamma、Base JSON-RPC、NVD/EPSS/CISA-KEV、crt.sh/RDAP/DoH）です。アドレス／ハッシュ／ドメインの入力はすべて検証され、SSRF 対策が施されています（上流ホストは固定されており、ユーザー指定のターゲットを受け付けるのは、スコープが明示された /scan/mcp とエンリッチメントエンドポイントのみです）。

ライセンス

MIT — LICENSE を参照してください。

エージェントフレームワークの使用例

取引前のトークンガード（/gate/swap、Base 上で x402 経由の $0.008 USDC）。無料サンプル：curl "https://x402-data-api.sigrunner.workers.dev/gate/swap/preview?token=degen"

• Node：docs/examples/swap-gate/gate.mjs
• LangChain.js ツール：docs/examples/langchain/swapGuardTool.mjs
• ElizaOS アクション：docs/examples/elizaos/swapGuardAction.mjs

マーケットデータの購入者（価格データを購入し、古いデータをリアルタイムのものとして提示してはならないエージェント向け — Decision402 パターン）：examples/market-data-decision-buyer.mjs。エージェントの一連の処理を実行します。ライブの 402 見積もりを読み取り、呼び出しごとの USDC 予算を適用し、無料プレビューでフィードを検証し、/crypto/prices に支払った後（Base 上で $0.001）、MAX_AGE_SECONDS より古い行をすべて拒否します。手順 1〜3 は npm のインストールなしで実行できます：node examples/market-data-decision-buyer.mjs bitcoin,ethereum。

Python / LangChain / CrewAI

pip install "git+https://github.com/rezearcher/greyridge-x402-tools" — token_report() および swap_gate() ヘルパー（デフォルトでは無料プレビュー、オプションで有料の x402 モード）と LangChain ツールを利用できます。ガイド：https://rezearcher.github.io/greyridge-x402-tools/

お使いのトークンで無料で試す

curl "https://x402-data-api.sigrunner.workers.dev/chain/token-report/preview?token=0xYourBaseToken" を実行すると、有料ルート（$0.01）と同じ詳細なレポートが返されます。/gate/swap/preview?token=0x… では、1 日あたり IP ごとに、実際のトークンを使った GO/HOLD/BLOCK チェックを 3 回無料で利用できます。

エージェントスキル（OpenClaw/Hermes 系エージェントにそのまま導入できる SKILL.md）：https://github.com/rezearcher/greyridge-token-safety-skill

MCP サーバー用 CI ゲート

uses: rezearcher/x402-data-api/actions/mcp-scan@main に url: または tools-file: を指定すると、CI で無料の MCP ツールポイズニングプレビューを実行し、判定が block の場合に失敗します。actions/mcp-scan/README.md を参照してください。

Python に関する注意：デフォルトの Python-urllib User-Agent は Cloudflare のエッジで拒否され、403 が返されます。requests／httpx を使用するか、任意のカスタム User-Agent ヘッダーを設定してください。