リクエスト単位で支払う。
アカウントもキーも不要。

全エンドポイントを Coinbase x402 Bazaar(facilitator のディスカバリカタログ)に掲載しています。エージェントは意図で検索し、リソース URL・価格・入力スキーマを取得できます。同じ情報は 402 レスポンス自体にも載っています — PAYMENT-REQUIRED ヘッダーの extensions.bazaar ブロックに、具体的な入力例・JSON スキーマ・出力例が入っているため、URL を知っているエージェントに別チャネルは不要です。

キーを付けずにリクエストを送ると、支払いチャレンジが返ります:

リクエスト(キーなし — 課金は発生しません)

curl -i "https://api.kakerapetit.dev/v2/companies/jp/7203"

レスポンス — 402 + 支払いチャレンジ

HTTP/2 402
content-type: application/json
payment-required: eyJ4NDAyVmVyc2lvbiI6MiwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLC4uLg==

{"error":"payment_required","message":"This endpoint is paid via the x402 protocol. ..."}

PAYMENT-REQUIRED を base64 デコード(抜粋)

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x...(seller wallet)",
      "resource": "https://api.kakerapetit.dev/v2/companies/jp/7203",
      "description": "Company profile and latest fundamentals for a Japanese listed company in an EDGAR-style unified schema."
    }
  ],
  "extensions": {
    "bazaar": "...(input example + JSON schema + output example)"
  }
}

amount はトークンの最小単位です — USDC は小数 6 桁なので 5000 = $0.005。この額の USDC 送金許可(EIP-3009)に署名し、署名済みペイロードを X-PAYMENT ヘッダーに載せて同じリクエストを再送すると、オンチェーン決済の結果が PAYMENT-RESPONSE ヘッダー付きで返ります。クライアントライブラリはこの一連を自動化します:

支払い可能なウォレットで fetch をラップすると、キーなしの呼び出しが可能になります — ラッパーが 402 を捕捉し、署名・再送・決済確認まで行います:

npm i @x402/fetch @x402/evm viem

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.WALLET_KEY); // holds USDC on Base
const client = new x402Client().register("eip155:8453", new ExactEvmScheme(account));
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://api.kakerapetit.dev/v2/companies/jp/7203");
console.log(await res.json()); // paid, settled, done

エージェントが生の HTTP ではなく MCP を話すなら、同じデータを API キー付きの 6 つの MCP ツールとして使えます(無料枠あり)— 多段リサーチを行うチャットエージェントに適しています。ドキュメントの MCP セクション、または /signup で無料キーを取得してください。