x402nano

x402nano

x402nano について

x402nano は、AI エージェントと MCP クライアント向けの、機械が支払える Polymarket 市場インテリジェンスです。無料の市場検索・価格取得ツールに加え、Base メインネットで呼び出しごとに 0.05 USDC が必要な、有料の読み取り専用 Market Brief ツールと Market Delta ツールを提供します。

取引や賭け、資金の保管は行わず、金融アドバイスも提供しません。購入者のキーは呼び出し元のローカルに保持され、x402nano が受け取ったり保存したりすることはありません。

稼働中のサービス： https://x402nano.onrender.com

公開 Market Watcher デモ： https://x402nano-market-watcher.bobjonesgood.chatgpt.site

x402nano は独立したプロジェクトであり、x402nano.org または Nano/XNO 暗号通貨とは関係ありません。「nano」は、プロジェクトが小規模な、リクエストごとに支払うインテリジェンスを対象としていることを示しています。x402、Base、Polymarket、USDC、MCP への言及は、技術的な互換性または公開データソースについて説明するものであり、推奨を意味するものではありません。

MCP サーバー

x402nano は、本番用の Streamable HTTP トランスポートを使用する、公開されたステートレスな MCP エンドポイントを提供します。

https://x402nano.onrender.com/mcp

リモートサーバーは、無料の市場検索・価格取得ツールと、x402 で保護された 0.05 USDC の Market Brief ツールおよび Market Delta ツールを提供します。有料の MCP 呼び出しでは、公式の x402 MCP 支払いフローを使用します。呼び出し元がローカルで署名し、ファシリテーターが Base 上で検証と決済を行います。x402nano が購入者の秘密鍵を受け取ったり保存したりすることはありません。

このリポジトリには、保守的な支払い上限を設定した、実績のあるローカル stdio MCP サーバーも残されています。どちらの接続方法についても、無償での検証とクライアントの要件とあわせて、mcp-server/README.md を参照してください。標準に準拠したリモートサーバーのマニフェストは server.json です。

エージェント向けクイックスタート

新しい MCP クライアントまたは自律型エージェントの場合：

1. 公式 MCP Registry で io.github.Bobjonesgood/x402nano を検索します。
2. Streamable HTTP リモートに接続します：https://x402nano.onrender.com/mcp。
3. ツール一覧を取得し、list_trending_markets、get_market_pricing、get_market_brief、get_market_delta があることを確認します。
4. list_trending_markets を呼び出し、市場のスラッグを選択します。
5. get_market_pricing を呼び出し、Base メインネットの価格を確認します。
6. get_market_brief または get_market_delta には、x402 対応の MCP クライアントを使用します。

価格と支払いの範囲：

• 無料ツール：list_trending_markets、get_market_pricing。
• 有料ツール：get_market_brief、get_market_delta。
• 価格：有料ツールの呼び出しごとに 0.05 USDC、50000 atomic units。
• ネットワーク：Base メインネット、eip155:8453。
• 販売者：0x4cc3831eB479aCFb6D44631d4a30814508Cf52d3。
• 購入者のキーは呼び出し元のローカルに保持されます。x402nano が購入者の秘密鍵を受け取ったり保存したりすることはありません。
• 出力は読み取り専用の市場インテリジェンスであり、取引、賭け、金融アドバイスではありません。

購入できるもの

x402nano は、Polymarket の生データを販売していません。市場のメタデータ、現在の価格、価格変動の履歴、スコアリング、レシート処理、安全上の境界をエージェント自身がつなぎ合わせる手間を省く、パッケージ化されたエージェント対応の市場インテリジェンスオブジェクトを販売しています。

有料の市場ブリーフには、以下が含まれます。

• 市場の識別情報、質問、カテゴリ、ステータス、終了日、ソース URL
• 現在の先行結果と暗示確率
• 結果の価格概要と上位の結果
• 取引量、24 時間取引量、7 日間取引量、流動性、および利用可能な場合の変化状況
• 利用可能な場合は、公開価格履歴に基づく 24 時間の値動きの概要
• 解決方法／ソースに関する状況とデータ品質に関する注記
• 値動き、注目度、データの完全性に関する説明的なスコア
• 今後エージェントが確認すべき監視ポイント
• 有料コンテンツのロック解除を証明するレシートメタデータ
• 投資助言を行わない旨の境界

有料の市場差分には、以下が含まれます。

• 呼び出し元が指定した since タイムスタンプ以降に変化した内容
• 公開履歴が利用可能な場合の、先行結果の開始時と終了時の確率
• 確率の絶対変化と相対変化
• 方向、変化の有無、再確認の優先度、異常な値動きの有無
• 現在の取引量／流動性の状況
• 利用可能な場合の推移ポイント
• 履歴データの欠落または最も近いポイントを説明するデータ品質に関する注記
• 有料コンテンツのロック解除を証明するレシートメタデータ
• 投資助言を行わない旨の境界

有料ブリーフの代表的なレスポンス：

{
  "status": "unlocked",
  "receipt": {
    "id": "receipt-id-after-payment",
    "amount": "0.05",
    "asset": "USDC",
    "network": "eip155:8453"
  },
  "data": {
    "briefType": "read-only-market-intelligence",
    "market": {
      "slug": "example-polymarket-slug",
      "question": "Will example event happen in 2026?",
      "status": "active",
      "url": "https://polymarket.com/event/example"
    },
    "snapshot": {
      "generatedAt": "2026-06-29T12:00:00.000Z",
      "source": "polymarket:gamma",
      "leadingOutcome": "Yes",
      "leadingOutcomeImpliedProbability": "42.0%"
    },
    "metrics": {
      "volume24h": "17,260.91",
      "liquidity": "81,697.04"
    },
    "movement": {
      "window": "24h",
      "direction": "up",
      "absoluteChange": "0.032"
    },
    "scores": {
      "marketMovementScore": 61,
      "attentionScore": 72,
      "dataCompletenessScore": 100,
      "unusualMovementFlag": false
    },
    "watchPoints": [
      "Watch whether the leading outcome changes, flattens, or reverses over the next observation window."
    ],
    "boundaries": [
      "Read-only public market data summary.",
      "No trading execution.",
      "No custody of user funds.",
      "No buy/sell/bet recommendation."
    ]
  }
}

有料差分の代表的なレスポンス：

{
  "status": "unlocked",
  "receipt": {
    "id": "receipt-id-after-payment",
    "amount": "0.05",
    "asset": "USDC",
    "network": "eip155:8453"
  },
  "data": {
    "briefType": "read-only-market-delta",
    "market": {
      "slug": "example-polymarket-slug",
      "question": "Will example event happen in 2026?"
    },
    "window": {
      "since": "2026-06-29T11:00:00.000Z",
      "until": "2026-06-29T12:00:00.000Z"
    },
    "change": {
      "source": "polymarket:clob",
      "outcome": "Yes",
      "startProbability": 0.388,
      "endProbability": 0.42,
      "absoluteChange": "0.032",
      "relativeChange": "+8.2%",
      "direction": "up",
      "changed": true
    },
    "significance": {
      "repeatCheckPriority": "medium",
      "unusualMovementFlag": false,
      "summary": "The leading outcome moved up by 0.032 over the requested window."
    },
    "dataQuality": {
      "priceHistoryAvailable": true,
      "usedNearestHistoryPoint": false,
      "notes": [
        "Delta is computed from available public market data.",
        "This endpoint does not store caller state; clients provide the since timestamp."
      ]
    }
  }
}

鮮度と方法論：

• 有料ブリーフと差分は、有効な支払いの後、リクエストに応じて生成されます。
• 公開される鮮度メタデータでは、想定される最大経過時間として 90 秒が示されます。有料コンテンツは、支払いが完了するまで 402 の背後に保持されます。
• ブリーフの値動きには、利用可能な場合、Polymarket の最新の公開データと先行結果の 24 時間の履歴が使用されます。
• 差分の値動きは、呼び出し元が指定した since タイムスタンプから、利用可能な最新のポイントまでの、先行結果トークンに関する Polymarket の公開 CLOB 価格履歴に基づいて算出されます。
• 正確な履歴を利用できない場合、精度が高いかのように装うのではなく、レスポンスの dataQuality でその旨を示します。
• スコアは、値動きの大きさ、取引量、流動性、データの利用可能性に基づく説明的なヒューリスティックです。予測や推奨ではありません。

AI エージェントおよびボット向けの、機械決済可能な市場インテリジェンス API です。

x402nano は、HTTP 402 の支払いフローを通じて、読み取り専用の Polymarket 市場ブリーフを提供します。エージェントが市場ブリーフをリクエストすると、支払いチャレンジを受け取り、X-PAYMENT を付けて再試行し、ロック解除された JSON とレシートを受け取ります。

これは市場インテリジェンスのインフラであり、取引の助言ではありません。

有料ブリーフには、24 時間の市場の値動き、取引量／流動性の状況、解決方法に関する状況、監視ポイント、安全な説明的スコアが含まれます。取引の実行、資産の保管、賭けに関する助言、売買の推奨は含まれません。

ライブエンドポイント

https://x402nano.onrender.com

無料の検索／トレンドエンドポイント：

GET https://x402nano.onrender.com/api/markets/trending

有料の市場ブリーフエンドポイント：

GET https://x402nano.onrender.com/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel

有料の市場差分エンドポイント：

GET https://x402nano.onrender.com/api/markets/delta?slug=will-gideon-saar-be-the-next-prime-minister-of-israel&since=2026-06-15T12:00:00Z

Historical Mainnet Proofs

これらは、Base メインネット上で実施された、個別にオーナーの承認を得た過去のテストです。過去に有料でアンロックされたことを示すものであり、支払いを行うための手順ではありません。

Proof	Initiated by	Purchased resource	Price and network	Transaction	Current behavior
コア Market Brief の直接購入	x402nano 専用のローカル購入スクリプト	GET /api/markets/brief?slug=...	Base メインネット上の 0.05 USDC（eip155:8453）	BaseScan · レシート f1ffa2f5cabf94c3	コアの有料 Brief エンドポイントは現在も稼働しています。このトランザクションは過去のものです。
コア Market Delta の直接購入	x402nano 専用のローカル購入スクリプト	GET /api/markets/delta?slug=...&since=...	Base メインネット上の 0.05 USDC（eip155:8453）	BaseScan · レシート 75fe7c800fed47d4	コアの有料 Delta エンドポイントは現在も稼働しています。このトランザクションは過去のものです。証明に関する注記を参照してください。
Market Watcher コンパニオンクライアントによる証明	オーナー承認済みの制御された Market Watcher クライアント	コンパニオン購入フローを通じた x402nano の Market Brief 1 件	Base メインネット上の 0.05 USDC（eip155:8453）	BaseScan	過去のコンパニオンクライアントによる証明のみです。公開中の Market Watcher デプロイは引き続きモック優先で、実際の支払いは無効になっており、購入者用キーもありません。

コアの直接購入による証明テストでは、HTTP 402 チャレンジ、ローカルで署名した支払いの再試行、オンチェーンでの USDC 決済、レシートの生成、読み取り専用 JSON のアンロックを検証しました。販売者のウォレットは 0x4cc3831eB479aCFb6D44631d4a30814508Cf52d3 でした。

証明の参照先：

Direct core Market Brief transaction:
https://basescan.org/tx/0x54ba49a288a56d20046c25f4496bec405f2eefc05fe413cd511caf96227911b1

In-repo proof notes:
TRUST.md
ARCHITECTURE.md
LISTING_METADATA.md
DIRECT_DELTA_X402_PRODUCTION_UNLOCK_PROOF.md

注：ローカル購入スクリプトは、実際にアンロックされた後、支払い直後に購入者の残高を読み取った際に古い値が返されたため、ゼロ以外の終了コードで終了しました。販売者の残高は更新され、レシートとイベントは記録されました。また、後から支払いなしで残高を確認したところ、購入者の残高が 1.00 から 0.95 USDC に変わったことが確認できました。

購入者フロー

1. API を検出します。

GET https://x402nano.onrender.com/.well-known/x402.json

2. 有料の市場 Brief をリクエストします。

Invoke-WebRequest `
  -Uri "https://x402nano.onrender.com/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel" `
  -UseBasicParsing

3. 402 Payment Required が返されることを確認します。

レスポンスには、次のような支払い要件が含まれます。

{
  "error": "payment_required",
  "paymentRequirements": {
    "network": "eip155:8453",
    "asset": "USDC",
    "amount": "0.05",
    "payTo": "0x4cc3831eB479aCFb6D44631d4a30814508Cf52d3",
    "resource": "/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel"
  }
}

4. x402 の支払いに署名して送信します。

x402 対応クライアントを使用して Base メインネットの USDC 支払いに署名し、次の情報を付けて同じリクエストを再試行します。

X-PAYMENT: <signed-x402-payment>

5. アンロックされた JSON を受け取ります。

支払いに成功したレスポンスには、レシートと市場 Brief のペイロードが含まれます。

{
  "receipt": {
    "id": "f1ffa2f5cabf94c3",
    "network": "eip155:8453",
    "amount": "0.05",
    "asset": "USDC"
  },
  "data": {
    "briefType": "read-only-market-intelligence",
    "status": "ok",
    "market": {
      "slug": "will-gideon-saar-be-the-next-prime-minister-of-israel"
    },
    "movement": {
      "window": "24h",
      "direction": "flat",
      "trajectory": []
    },
    "metrics": {
      "volume24h": "17,260.91",
      "liquidity": "81,697.04"
    },
    "resolution": {
      "endDate": "2026-12-31T00:00:00Z"
    },
    "scores": {
      "marketMovementScore": 45,
      "attentionScore": 70,
      "dataCompletenessScore": 100,
      "unusualMovementFlag": false
    }
  }
}

Delta Brief

Delta Brief は、エージェントのポーリングループで繰り返し利用する有料コンテンツです。Brief は「この市場の現在の状況は？」に答え、Delta は「エージェントが最後に確認してから何が変わったか？」に答えます。

GET https://x402nano.onrender.com/api/markets/delta?slug=will-gideon-saar-be-the-next-prime-minister-of-israel&since=2026-06-15T12:00:00Z

支払いがない場合、ルートは 402 Payment Required を返します。有効な X-PAYMENT を付けて再試行すると、レシートと読み取り専用の Delta JSON を含むレスポンスが返されます。

{
  "status": "unlocked",
  "receipt": {
    "id": "receipt-id-after-payment",
    "network": "eip155:8453",
    "amount": "0.05",
    "asset": "USDC"
  },
  "data": {
    "briefType": "read-only-market-delta",
    "market": {
      "slug": "will-gideon-saar-be-the-next-prime-minister-of-israel"
    },
    "window": {
      "since": "2026-06-15T12:00:00.000Z",
      "until": "2026-06-15T18:30:00.000Z"
    },
    "change": {
      "available": true,
      "outcome": "Yes",
      "absoluteChange": "0.050",
      "relativeChange": "+11.9%",
      "direction": "up",
      "changed": true
    },
    "significance": {
      "repeatCheckPriority": "high",
      "unusualMovementFlag": true,
      "summary": "The leading outcome moved up by 0.050 over the requested window."
    }
  }
}

Delta Brief は、エージェント向けの市場に関する説明的なコンテキストです。取引の実行、カストディ、ベッティングの助言、予測、売買の推奨は含まれません。

ポーリングクライアントの例：

examples/delta-polling.js
examples/delta-polling.py

どちらの例も、想定されるエージェントのループを示しています。鮮度メタデータを確認し、Delta をリクエストし、402 を処理して、呼び出し元から提供された署名フックを使った x402 支払いとともに再試行します。その後、レシートと Delta ペイロードを解析し、レスポンスが成功したら since を更新します。

ローカル証明コマンド

通常どおりクローンした後、リポジトリのルートから次のコマンドを実行します。

事前確認のみです。署名も支払いの送信も行いません。

$env:MAINNET_PAID_PATH="/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel"
$env:MAINNET_MAX_USDC="0.05"
$env:MAINNET_PAYMENT_ACK="PREFLIGHT_ONLY"
npm.cmd run agent:mainnet

実際の支払いの例です。0.05 USDC のアンロックを意図的に 1 回送信する、個別にオーナーの承認を得たテストでのみ使用してください。

$env:MAINNET_PAID_PATH="/api/markets/brief?slug=will-gideon-saar-be-the-next-prime-minister-of-israel"
$env:MAINNET_MAX_USDC="0.05"
$env:MAINNET_PAYMENT_ACK="PAY_REAL_0.05_USDC"
npm.cmd run agent:mainnet

ローンチに向けたお願い

x402nano は、AI エージェント、トレーディングボット、市場データの開発者 20 名からのフィードバックを求めています。

確認してほしい点：

Would a machine-readable market brief be useful to your agent?
Is 0.05 USDC per brief the right shape for testing?
What fields would your bot need before paying for a brief?
Would you rather call this directly, through an SDK, or through another agent framework?

位置づけ：

Stop scraping. Use a machine-payable API for market briefs.
0.05 USDC per read-only market brief on Base.
No account. No API key. HTTP 402 and X-PAYMENT.

現在の対象範囲

対象：

Polymarket public data
read-only market intelligence
free trending endpoint
paid market brief endpoint
paid market delta endpoint
HTTP 402 challenge
Base mainnet USDC unlock
receipt and proof

今回のローンチでは対象外：

trading advice
trade execution
Telegram bot
lead generation
x402 consulting
new product features before feedback

開発

npm.cmd install
npm.cmd run build

コアスクリプト：

npm.cmd run agent:mainnet
npm.cmd run wallet:mainnet:create
npm.cmd run build

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。