polygon-discovery

Agentic Services (x402)

Agentic Services マーケットプレイス上の従量課金 API です。Polygon メインネット上の x402 支払いプロトコルによって制御されています。API キーやサブスクリプションは不要で、各呼び出しにはウォレットから差し引かれる少額の USDC が必要です。CLI（x402-pay）は 402 レスポンスを検出し、正確な支払いに署名して自動的に再試行します。

• ベース URL: https://agent-discovery.polygon.org
• ライブカタログ（信頼できる唯一の情報源）: GET https://agent-discovery.polygon.org/api/discover/routes
• プロバイダー向け完全ドキュメント: https://agent-discovery.polygon.org/SKILL.md

常に最初にライブカタログを読んでください。 カタログは、すべての有効なルートをその正確なプロキシパス、メソッド、価格、payTo アドレスとともに返します（CORS 有効、読み取りに支払いは不要です）。価格と利用可能なサービスは変化するため、カタログを権威ある情報源として扱い、このファイルは概要把握のためのものと考えてください。

---

前提条件 — x402 呼び出しの前に確認する

すべての呼び出しは、資金を入れた Polygon ウォレットから USDC を消費します。x402-pay を実行する前に:

agent wallet list        # is a wallet configured?

ウォレットが 1 つも表示されない場合は、セットアップしてください:

1. agent wallet login: ブラウザで agentconnect のログインページを開きます。Google またはメールでサインインします（ヘッドレスホストでも動作し、追加のフラグは不要です）。事前のセットアップ手順は必要ありません。キーはデフォルトで設定され、ログイン時に Builder の認証情報が自動的にプロビジョニングされます。
2. agent wallet address: アドレスを取得し、資金を入れます（agent fund）
3. agent balances: x402 エンドポイントを呼び出す前に、Polygon（チェーン 137）で USDC が利用可能であることを確認します

ウォレットは存在するものの balances が 0 USDC を示す場合は、ユーザーに資金を入れるよう案内してください。そうでなければ x402-pay は EOA の資金エラーで失敗します。すべてのサービスは Polygon 上の USDC（0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359、チェーン ID 137）で決済されます。

---

サービスの呼び出し方

カタログにある完全なルート URL を使用してください。リクエストボディとクエリパラメータは、上流プロバイダー自身の API をそのまま反映しています。

# POST with a JSON body (e.g. Exa web search)
agent x402-pay \
  --url "https://agent-discovery.polygon.org/api/proxy/exa/search" \
  --wallet main --method POST \
  --body '{"query": "polygon agentic payments", "numResults": 5}'

# GET with query params (e.g. SearchApi Google search)
agent x402-pay \
  --url "https://agent-discovery.polygon.org/api/proxy/searchapi/google?q=<query>" \
  --wallet main --method GET

# Scrape a page to clean markdown (Firecrawl)
agent x402-pay \
  --url "https://agent-discovery.polygon.org/api/proxy/firecrawl/scrape" \
  --wallet main --method POST --body '{"url": "https://example.com"}'

# LLM inference (Llama 3.3 70B, OpenAI-compatible chat body)
agent x402-pay \
  --url "https://agent-discovery.polygon.org/api/proxy/nim/llama-3.3-70b/chat" \
  --wallet main --method POST \
  --body '{"messages": [{"role": "user", "content": "Summarize Polygon in one line."}]}'

チェーンとトークンは 402 レスポンスから自動検出されます — 手動設定は不要です。

---

カタログ

価格は 1 回の呼び出しあたりの USDC で、Polygon（チェーン 137）で決済されます。以下のすべてのルートは、ベース URL https://agent-discovery.polygon.org からの相対パスです。

検索、スクレイピング、ニュース（プロキシ経由）

サービス	メソッド	ルート	価格
Exa — AI ウェブ検索	POST	/api/proxy/exa/search	$0.001
SearchApi — Google 検索	GET	/api/proxy/searchapi/google	$0.001
Firecrawl — Markdown へのスクレイピング	POST	/api/proxy/firecrawl/scrape	$0.002
NewsAPI — トップヘッドライン	GET	/api/proxy/news/headlines	$0.001

AI 推論（プロキシ経由）

サービス	メソッド	ルート	価格
NVIDIA NIM — Llama 3.3 70B（チャット）	POST	/api/proxy/nim/llama-3.3-70b/chat	$0.01
NVIDIA NIM — Llama 3.2 90B Vision（画像 + チャット）	POST	/api/proxy/nim/llama-3.2-vision/chat	$0.01
OpenRouter — 200 以上のモデル（GPT、Claude、Gemini、Llama…）	POST	/api/proxy/openrouter/chat	$0.01

ウェブ自動化とメール（プロキシ経由）

サービス	メソッド	ルート	価格
Browserbase — クラウドブラウザセッション	POST	/api/proxy/browserbase/sessions	$0.001
Resend — トランザクションメールの送信	POST	/api/proxy/resend/send	$0.005

オンチェーンデータ、メール受信トレイ & RPC (外部プロバイダー)

これらは x402 ネイティブのプロバイダーです。それぞれ固有のエンドポイント URL を直接呼び出します（/api/proxy/* パスではありません）。決済は引き続き Polygon 上の USDC で行われます。x402-pay は 402 をまったく同じように処理します。以下に示す完全な URL を --url として渡してください。

QuickNode RPC — $0.001/呼び出し、標準的な JSON-RPC を POST します。URL パターンは https://x402.quicknode.com/<chain>/:

チェーン	<chain> スラッグ		チェーン	<chain> スラッグ
Polygon	matic-mainnet		Optimism	optimism-mainnet
Polygon Amoy	matic-amoy		Avalanche	avalanche-mainnet
Polygon zkEVM	zkevm-mainnet		BSC	bsc-mainnet
Base	base-mainnet		Linea	linea-mainnet
Ethereum	ethereum-mainnet		Scroll	scroll-mainnet
Solana	solana-mainnet		Sui	sui-mainnet
Arbitrum	arbitrum-mainnet		TON	ton-mainnet
Bitcoin	btc-mainnet		Tron	tron-mainnet

agent x402-pay \
  --url "https://x402.quicknode.com/matic-mainnet/" \
  --wallet main --method POST \
  --body '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Allium — オンチェーンウォレット分析 — ベース https://agents.allium.so/api/v1/developer/:

エンドポイント	メソッド	完全な URL	価格
ウォレット残高	POST	…/wallet/balances	$0.03
ウォレット PnL	POST	…/wallet/pnl	$0.03
ウォレットトランザクション	POST	…/wallet/transactions	$0.03
ウォレット残高履歴	POST	…/wallet/balances/history	$0.01
価格 (最新)	POST	…/prices	$0.02
指定タイムスタンプ時点の価格	POST	…/prices/at-timestamp	$0.02
価格履歴	POST	…/prices/history	$0.02
トークン一覧	GET	…/tokens	$0.03
トークン検索	GET	…/tokens/search	$0.03

AgentMail — エージェント用メール受信トレイ — $2/呼び出し、ベース https://x402.api.agentmail.to/v0/inboxes:

エンドポイント	メソッド	完全な URL
受信トレイを作成	POST	https://x402.api.agentmail.to/v0/inboxes
メッセージ一覧	GET	…/{inbox_id}/messages
メッセージを取得	GET	…/{inbox_id}/messages/{message_id}
メッセージを送信	POST	…/{inbox_id}/messages/send
メッセージに返信	POST	…/{inbox_id}/messages/{message_id}/reply
スレッド一覧	GET	…/{inbox_id}/threads

---

x402 の仕組み

1. CLI がリクエストをエンドポイントに送信します。
2. エンドポイントが HTTP 402 Payment Required と支払いの詳細（価格、アセット、ネットワーク、payTo）を返します。
3. CLI がウォレットから正確な金額に対して EIP-3009 の transferWithAuthorization に署名します。
4. CLI が支払いヘッダーを付けてリクエストを再試行します。
5. エンドポイントが検証し、上流の API を呼び出してレスポンスを返します。決済の tx ハッシュは PAYMENT-RESPONSE ヘッダーで返されます。

このフロー全体はエージェントに対して透過的です。チェーンとトークンは 402 レスポンスから自動検出されます。エンドポイントを推測したり、プロバイダーをウェブで検索したりしないでください。正しい最新の URL と価格については、ライブカタログ（/api/discover/routes）を参照してください。