ETH perpetual snapshot
GET /v1/eth/snapshot → expected HTTP 402 Payment requirements appear here.
An agent can pay the Router in Base Sepolia USDC to reach a provider paid in Tempo pathUSD. The Router makes that second payment from its own prefunded balance. Start by exploring routes and a quote, without a wallet.
Testnet-only proof of concept. Unaudited, not for production.
md-mpp-eth-snapshotThere is no app for people here. The Router is an MCP server, and the page you are reading has a plain-text twin for agents: /router/llms.txt. Tell your agent what you want; it reads that file, registers the Router itself and asks you to restart. This works the same with Claude Code, OpenAI Codex CLI and Grok Build (verified 2026-10-12). Keys, passphrases and the approval of each purchase stay with you.
A newly added MCP server is loaded when a session starts, so expect one restart. Nothing is paid until you approve a purchase yourself.
Set up SubEtha Router for me. The instructions are at
https://subethalabs.com/router/llms.txt
Then list the routes and quote https://x402.vercel.app/protected
through a dynamic profile. Quote only; do not purchase.What the agent will do: run claude mcp add --scope user --transport http subetha-router https://router.subethalabs.com/mcp (Codex: codex mcp add subetha-router --url …; Grok Build: grok mcp add subetha-router …), ask you to restart, list the routes, and show you a quote with the upstream URL, the price and the fee. To pay, it installs the local payer (npm i -g @subetha/payer, version 0.2.0 pays on every rail the Router offers, fixed routes and provider URLs alike) and asks you to create the wallet, fund it from a testnet faucet and start the daemon in your own terminal; every purchase is approved in a native dialog on your Mac (type the passphrase, then click Approve).
This is the flow shown in our demo video, recorded on 2026-10-13 with Claude Code on a Mac. Nothing here needs a repository clone: the Router is hosted, the payer is on npm, and the instructions are on this page.
That is all you type. The agent finds this page, reads /router/llms.txt, and registers the hosted Router, an MCP server, by itself. You restart the agent once.
Dynamic routes take a provider’s URL. In the demo: a SOL/USD price API we run that accepts only USDC on Solana devnet, provider-x402-sol.subethalabs.com/v1/sol/snapshot, while the agent’s wallet holds USDC on Base Sepolia.
npm i -g @subetha/payer. You create the wallet, fund its address from any testnet faucet and start the daemon in your own terminal. It asks you before every payment. A budget mode without per-purchase approval is planned, not built.
The agent hands the payer the URL. The quote shows the provider’s price plus a small Router fee: 10000 + 1000 = 11000 base units (0.011 USDC), the recipient and the deadline. No funds move at a quote.
The payer’s dialog shows your security phrase and the exact terms: profile, upstream URL, price. You type the passphrase and click Approve. The agent never sees the passphrase or the key.
Payment one: your wallet pays the Router on Base Sepolia (USDC, x402). Payment two: the Router pays the provider on Solana devnet from its own balance (USDC, x402). The provider’s JSON comes back as delivered.
The payer holds your key; the hosted Router never does. There is no human-facing app: the Router is an MCP server, and the agent calls it directly.
A supported payment rail can connect your agent to an API that accepts another, without acquiring the provider’s asset.
The agent pays the Router using a supported asset and network. Listing routes and requesting a quote never initiate payment.
The Router separately pays the provider from its own prefunded balance, then returns the API response. This is not a swap or bridge; it does not guarantee unlinkability or anonymity. The two payments are not atomic.
10 fixed routes · 20 dynamic profiles in the public listing checked on 2026-10-09. Use the live list for current availability; a listing is not a payment-success guarantee.
| Protocol | Test network | Asset |
|---|---|---|
| x402 exact | Base Sepolia | USDC |
| x402 exact | Arc testnet | USDC |
| x402 exact | Solana devnet | USDC |
| MPP tempo/charge | Tempo testnet | pathUSD |
| MPP solana/charge | Solana devnet | USDC |
Same-rail pairs are excluded: 5 × 4 = 20 dynamic profiles. These include different chains using the same protocol, and x402 ↔ MPP on Solana devnet. Fixed routes use operator-selected providers; dynamic profiles let you specify a compatible provider.
Through 2026-10-08, all 20 cross-rail pairs have historical hosted-testnet records verifying both payment legs on chain and an API response.
Not every attempt succeeded: a paid attempt also ended without usable data. This is historical evidence, not a fresh sweep or a production guarantee. Independent finality checks in those records do not mean the Router automatically verifies finality; its proof.onChainFinality reports not_checked.
On 2026-10-13 we added x402 inbound and outbound for Robinhood Chain testnet (USDG), Arbitrum Sepolia (USDC) and HyperEVM testnet (USDC) with a self-hosted facilitator, and settled every cross pair with the five hosted rails and among themselves: 36 pairs, both legs on chain, API response returned. This ran on a local Router build. The hosted Router does not offer these rails yet; trust the live listing. Ethereum Sepolia (USDC) inbound and outbound were verified the same way and are left out of the table.
| pays ↓ / receives → | Base x402 · USDC | Arc x402 · USDC | Solana x402 · USDC | Tempo MPP · pathUSD | Solana MPP · USDC | Robinhood x402 · USDG | Arbitrum Sepolia x402 · USDC | HyperEVM x402 · USDC |
|---|---|---|---|---|---|---|---|---|
| Base x402 · USDC | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Arc x402 · USDC | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Solana x402 · USDC | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ |
| Tempo MPP · pathUSD | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ |
| Solana MPP · USDC | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ |
| Robinhood x402 · USDG | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ |
| Arbitrum Sepolia x402 · USDC | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ |
| HyperEVM x402 · USDC | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
✓ 20 pairs settled on the hosted Router (historical records through 2026-10-08) · ✓ 36 pairs settled on a local Router build (2026-10-13) · — same rail, not offered · 56 cross-rail pairs in all.
Two bounded purchases were made on mainnet with a Router running on the owner’s machine: on 2026-10-10 a price API (Tempo MPP in, Base x402 out), and on 2026-10-13 a real search on Exa’s API, with a request body (Tempo mainnet MPP in, Base mainnet x402 out to api.exa.ai/search). Both legs are on chain. The hosted Router stays testnet-only.
No repository clone, wallet, key or Router account is needed. The list and quote tools never initiate payment. Choose an MCP client, or use curl below to list routes without a paid agent client.
In Claude Code, register the hosted HTTP endpoint with this command.
claude mcp add --scope user --transport http subetha-router https://router.subethalabs.com/mcpAdd this HTTPS MCP endpoint in your client’s connection settings. Client availability and pricing are separate from Router access.
https://router.subethalabs.com/mcpPaste this instruction into the connected agent. If the example route is no longer listed, it must stop without substituting another route.
Do not pay. Use only subetha_router_list_routes and subetha_router_quote. First call subetha_router_list_routes. If md-mpp-eth-snapshot is still listed, call subetha_router_quote exactly once with that routeId and a fresh UUID requestId. If it is absent, stop. Explain the source (agent to Router) and destination (Router to provider), including protocol, network, asset, amount, decimals, expiry and fundsMoveOnCredential. Then STOP at the quote. Do not sign, read keys, create a wallet, approve, or call purchase. Do not call any other tools.This raw HTTP request uses curl only. It lists routes; it does not quote, sign or pay.
curl -sS --max-time 30 https://router.subethalabs.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"subetha_router_list_routes","arguments":{}}}'Check the JSON-RPC result.structuredContent: expect ok: true, routes and dynamic.profiles. SSE responses may put the JSON on data: lines. HTTP 200 alone is not success; check for JSON-RPC or tool errors. Use the returned listing for current counts.
These two reference providers let you inspect an unpaid HTTP 402 response in your browser. This is a provider payment challenge, not API data or a Router quote.
GET /v1/eth/snapshot → expected HTTP 402 Payment requirements appear here.
GET /v1/eth/snapshot → expected HTTP 402 Payment requirements appear here.
Both are operated by us, not Hyperliquid or Uniswap. The paid market data is a read-only mainnet reference, not an executable trading quote. These buttons only read payment requirements.
Public local signing setup is being prepared. Paid trials require an available local signer, funds on the matching testnet (including any network fees), and explicit human approval.
Approve before any potentially spending signing step. Tempo MPP credential creation sends funds before purchase. Solana MPP locally signs first; the Router broadcasts at purchase, and the caller needs devnet SOL for the fee. Read fundsMoveOnCredential and the rail-specific behavior; the flag is not evidence that payment completed.
approval=quoteId binds a purchase to a quote; it does not prove human consent. The client must obtain that consent. The server cannot verify that a human actually approved. A Router rejection does not mean no funds moved: a Tempo credential may already have sent them.
Do not automatically retry paid_data_unavailable, unknown or awaiting_payment. These outcomes are not proof of nonpayment. Reconcile the existing outcome first; a new purchase requires a fresh quote and renewed human approval before signing. No refund is guaranteed.
Dynamic profiles accept conditional provider URLs, not arbitrary APIs: public HTTPS, a supported protocol, network and asset, and matching price and challenge constraints. Redirects are not supported. The quote includes the provider price plus the Router fee. Providers are unverified; only a GET response containing an application/json object up to 256 KiB is supported. Payment can succeed without usable data, and there is no refund guarantee.
These instructions end at discovery and a static quote. Public local signing setup is still being prepared; connecting an MCP client alone does not provide a signer or testnet funds.
No caller private key is given to the Router. The caller signs locally and supplies a signed payment credential, which can authorize inbound settlement. The Router uses its own key and prefunded balance for the separate outbound payment.
No. Separate funding does not guarantee unlinkability or anonymity. This routing PoC makes no privacy or atomic-settlement guarantee.
No. It is an unaudited, testnet-only proof of concept. Historical settlement and data-delivery records do not guarantee current availability or future purchase results.
We were building SubEtha — private machine payments for x402, settled on zERC20 — and kept hitting the same wall from the other side: a payment method is only as useful as the set of APIs that accept it. Routing is what makes a rail worth holding. The privacy work and this are the same problem approached from two ends.
エージェントは Base Sepolia の USDC で Router に払い、Tempo の pathUSD を受け取るプロバイダに到達できます。Router は自身の事前資金で、その2つ目の支払いを行います。まずはウォレットなしで、ルートと見積を確認できます。
テストネット限定の概念実証(PoC)です。未監査・本番用途には使えません。
md-mpp-eth-snapshotここに人間向けのアプリはありません。Router は MCP サーバで、このページにはエージェント向けのテキスト版 /router/llms.txt があります。エージェントにやりたいことを伝えれば、エージェントがそれを読んで自分で Router を登録し、再起動を頼んできます。Claude Code、OpenAI Codex CLI、Grok Build のどれでも同じです(2026-10-12 に確認)。鍵、パスフレーズ、各購入の承認はあなたの手元に残ります。
追加した MCP サーバはセッション開始時に読み込まれるため、再起動が 1 回入ります。あなたが購入を承認するまで、何も支払われません。
Set up SubEtha Router for me. The instructions are at
https://subethalabs.com/router/llms.txt
Then list the routes and quote https://x402.vercel.app/protected
through a dynamic profile. Quote only; do not purchase.エージェントがすること: claude mcp add --scope user --transport http subetha-router https://router.subethalabs.com/mcp(Codex は codex mcp add subetha-router --url …、Grok Build は grok mcp add subetha-router …)を実行し、再起動を頼み、ルートを一覧し、上流 URL・価格・手数料つきの見積を見せます。支払うときはローカルの payer(npm i -g @subetha/payer。0.2.0 は Router の全レール、固定ルートも URL 指定も払えます)を入れ、ウォレットの作成、testnet の faucet からの入金、デーモンの起動はあなた自身の端末で行うよう頼みます。各購入は Mac のネイティブダイアログで承認します(パスフレーズを入力して Approve をクリック)。
デモ動画と同じ流れです(2026-10-13、Mac 上の Claude Code で収録)。リポジトリの clone は要りません。Router はホスト済み、payer は npm にあり、手順はこのページにあります。
入力するのはこれだけです。エージェントはこのページを見つけ、/router/llms.txt を読み、MCP サーバであるホスト済み Router を自分で登録します。あなたはエージェントを 1 回再起動します。
動的ルートはプロバイダの URL を受け取ります。デモでは、Solana devnet の USDC しか受け付けない当方運用の SOL/USD 価格 API(provider-x402-sol.subethalabs.com/v1/sol/snapshot)を、Base Sepolia の USDC を持つウォレットから買いました。
npm i -g @subetha/payer。ウォレットを作り、そのアドレスにテストネットの faucet から入金し、自分のターミナルで daemon を起動します。payer は支払いのたびにあなたに確認します。1 件ごとの承認なしで予算内で買えるモードは予定であり、まだありません。
エージェントが payer に URL を渡すと、見積にはプロバイダの価格と Router の少額の手数料が出ます。10000 + 1000 = 11000 base units(0.011 USDC)、受取先、期限。見積では資金は動きません。
payer のダイアログに、あなたのセキュリティフレーズと、プロファイル・上流 URL・価格といった正確な条件が出ます。パスフレーズを入力して Approve を押します。エージェントはパスフレーズも鍵も見ません。
支払い 1: あなたのウォレットが Base Sepolia で Router に払います(USDC、x402)。支払い 2: Router が自身の残高から Solana devnet でプロバイダに払います(USDC、x402)。プロバイダの JSON が delivered として返ります。
鍵を持つのは payer で、ホスト済み Router は決して持ちません。人間向けのアプリはなく、Router は MCP サーバで、エージェントが直接呼びます。
対応する決済レールがあれば、プロバイダの資産を手に入れずに、別のレールを受け付けるAPIへエージェントが到達できます。
エージェントは対応する資産・ネットワークで Router に支払います。ルート一覧と見積の取得は、支払いを開始しません。
Router は自身の事前資金から別途プロバイダに支払い、APIの応答を返します。スワップでもブリッジでもなく、支払い同士を関連付けられないことや匿名性を保証しません。2つの支払いはアトミックではありません。
2026-10-09 に確認した公開一覧は、10の固定ルート・20の動的プロファイル。現在の可用性は最新の一覧で確認してください。一覧への掲載は決済成功の保証ではありません。
| プロトコル | テストネット | 資産 |
|---|---|---|
| x402 exact | Base Sepolia | USDC |
| x402 exact | Arc testnet | USDC |
| x402 exact | Solana devnet | USDC |
| MPP tempo/charge | Tempo testnet | pathUSD |
| MPP solana/charge | Solana devnet | USDC |
同一レール同士は対象外のため、5 × 4 = 20の動的プロファイルです。同じプロトコルで異なるチェーンを使う組み合わせや、Solana devnet 上の x402 ↔ MPP も含みます。固定ルートは運営側が選んだプロバイダを使い、動的プロファイルでは条件に合うプロバイダを指定できます。
2026-10-08 までに、全20組について、ホスト版で両方の支払いのオンチェーン成立とAPI応答を確認した記録があります。
すべての試行が成功したわけではなく、支払ったのに利用可能なデータが得られなかった試行もあります。今回全組を再検証した結果でも、本番運用の保証でもありません。記録上の独立した finality 照合は、Router による自動検証を意味しません。Router の proof.onChainFinality は not_checked を返します。
2026-10-13 に、Robinhood Chain testnet(USDG)・Arbitrum Sepolia(USDC)・HyperEVM testnet(USDC)の x402 受信・送信を自前の facilitator で追加し、ホスト済みの 5 レールとの掛け合わせと新チェーン同士のすべて、36 組を決済しました(両レグともオンチェーン、API 応答あり)。これはローカルの Router ビルドで行ったものです。ホスト済み Router はこれらのレールをまだ提供していません。実際の一覧を正とみなしてください。Ethereum Sepolia(USDC)の受信・送信も同じ方法で検証しましたが、表には入れていません。
| 払う ↓ / 受け取る → | Base x402 · USDC | Arc x402 · USDC | Solana x402 · USDC | Tempo MPP · pathUSD | Solana MPP · USDC | Robinhood x402 · USDG | Arbitrum Sepolia x402 · USDC | HyperEVM x402 · USDC |
|---|---|---|---|---|---|---|---|---|
| Base x402 · USDC | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Arc x402 · USDC | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Solana x402 · USDC | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ | ✓ |
| Tempo MPP · pathUSD | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ | ✓ |
| Solana MPP · USDC | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ | ✓ |
| Robinhood x402 · USDG | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ | ✓ |
| Arbitrum Sepolia x402 · USDC | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — | ✓ |
| HyperEVM x402 · USDC | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | — |
✓ ホスト済み Router で決済した 20 組(2026-10-08 までの記録) · ✓ ローカルの Router ビルドで決済した 36 組(2026-10-13) · — 同一レール(提供なし) · 合計 56 組。
オーナーの手元で動かした Router で、メインネットの購入を 2 回、上限つきで行いました。2026-10-10 に価格 API(Tempo の MPP で受け、Base の x402 で支払い)、2026-10-13 に Exa の検索 API を本文つきの POST で(Tempo メインネットの MPP で受け、Base メインネットの x402 で api.exa.ai/search に支払い)。どちらも両レグがオンチェーンにあります。ホスト済み Router はテストネット専用のままです。
リポジトリの clone、ウォレット、鍵、Router のアカウントは不要です。一覧と見積のツールは支払いを開始しません。MCPクライアントを使うか、下の curl で有料エージェントクライアントなしに一覧を取得できます。
Claude Code では、このコマンドでホスト済みHTTPエンドポイントを登録します。
claude mcp add --scope user --transport http subetha-router https://router.subethalabs.com/mcpクライアントの接続設定に、この HTTPS MCP エンドポイントを追加してください。クライアント自体の利用条件・料金は Router への接続とは別です。
https://router.subethalabs.com/mcp接続したエージェントに次の指示を貼り付けてください。例のルートが一覧になければ、別ルートに置き換えずに停止します。
支払いはしないでください。使うツールは subetha_router_list_routes と subetha_router_quote だけです。まず subetha_router_list_routes を呼んでください。md-mpp-eth-snapshot がまだ一覧にあれば、その routeId と新しい UUID の requestId で subetha_router_quote を1回だけ呼んでください。なければ停止してください。受信側(エージェント→Router)と送信側(Router→プロバイダ)の protocol・network・asset・金額・decimals・有効期限・fundsMoveOnCredential を説明し、見積で必ず停止してください。署名、鍵の読取、ウォレット作成、承認、purchase はしないでください。他のツールも呼ばないでください。curl だけで送れるHTTPリクエストです。一覧のみを取得し、見積・署名・支払いは行いません。
curl -sS --max-time 30 https://router.subethalabs.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-03-26' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"subetha_router_list_routes","arguments":{}}}'JSON-RPC の result.structuredContent で、ok: true・routes・dynamic.profiles を確認してください。SSE形式では data: 行にJSONが入る場合があります。HTTP 200 だけでは成功とは判定できません。JSON-RPCやツールのエラーがないかも確認し、現在の件数は返された一覧を優先してください。
2つの参考プロバイダから、未払いの HTTP 402 応答をブラウザで確認できます。これはプロバイダの支払い条件であり、APIデータでも Router の見積でもありません。
GET /v1/eth/snapshot → 想定 HTTP 402 支払い条件をここに表示します。
GET /v1/eth/snapshot → 想定 HTTP 402 支払い条件をここに表示します。
どちらも当方が運営しており、Hyperliquid・Uniswap による運営ではありません。有料の市場データはメインネットの読み取り専用参照値で、約定可能な気配値ではありません。このボタンで読むのは支払い条件だけです。
一般向けのローカル署名の導入手順は準備中です。有料試用には、利用可能なローカル署名手段、対応テストネットの資金(必要なネットワーク手数料を含む)、人間による明示的な承認が必要です。
支出が起こり得る署名工程より前に承認してください。 Tempo MPP は credential 作成時に送金し、purchase より先に資金が動きます。Solana MPP はローカルで署名のみを行い、購入時に Router が broadcast します。呼び出し側は手数料用の devnet SOL が必要です。fundsMoveOnCredential と各レールの挙動を確認してください。このフラグは支払い完了の証拠ではありません。
approval=quoteId は購入を見積に束縛しますが、人間の同意を証明しません。 クライアントが同意を得る必要があり、サーバは実際に人間が承認したかを検証できません。Router が拒否しても、未払いとは限りません。Tempo の credential 作成ですでに送金されている可能性があります。
paid_data_unavailable・unknown・awaiting_payment の後は自動再試行しないでください。 これらは未払いの証拠ではありません。まず既存の結果を照合してください。新しい購入には、新しい見積と、署名前の人間による再承認が必要です。返金の保証はありません。
動的プロファイルで使えるURLには条件があり、任意のAPIが使えるわけではありません。公開 HTTPS、対応プロトコル・ネットワーク・資産、価格とチャレンジの制約に合う必要があり、リダイレクトは非対応です。見積にはプロバイダの代金と Router 手数料が含まれます。プロバイダは未検証です。対応する応答は GET による application/json のオブジェクトで、最大 256 KiB です。支払いが成立しても利用可能なデータが得られない場合があり、返金の保証はありません。
この手順は一覧取得と固定ルートの見積で終了します。一般向けのローカル署名の導入手順は準備中です。MCPクライアントを接続するだけでは、署名手段やテストネット資金は用意されません。
呼び出し側の秘密鍵を Router に渡すことはありません。呼び出し側がローカルで署名し、受信決済を許可し得る署名済みの支払い credential を渡します。Router は別個の送信決済に自身の鍵と事前資金を使います。
いいえ。資金が別であることは、支払い同士を関連付けられないことや匿名性を保証しません。このルーティング PoC は、秘匿性やアトミックな決済を保証しません。
いいえ。未監査・テストネット限定の概念実証です。過去の決済・データ取得記録は、現在の可用性や今後の購入結果を保証しません。
私たちは SubEtha——x402 の秘匿マシン決済を zERC20 で精算する仕組み——を作っていて、反対側から同じ壁にぶつかりました。決済手段の有用性は、それを受け付けるAPIの数で決まります。ルーティングは、そのレールを持つ価値を成立させる部分です。秘匿性の取り組みとこれは、同じ問題を両端から見たものです。