DexL Agents

x402 で API に支払う — わずか10行ほど

x402 は HTTP 402 を実用化したものです。サーバーは正確な料金とともに 402 Payment Required を返し、クライアントはステーブルコインでの支払いに署名して、同じリクエストを再送します。 アカウントも API キーも請求書も不要です。

この例では DexL Agents を呼び出します（チャットモデル、音声、ウェブ検索とクロール、オンチェーンデータの読み取り、為替レート、NLP ツール）。 ここにある内容は、URL を変えるだけで、どの x402 サーバーでも動作します。

1. 無料：ウォレットは一切不要

npm install
npm run free

free.mjs は2つの処理を行います。

• 無料枠（model: "dexl-free"）を呼び出します。支払いヘッダーもウォレットもアカウントも不要です。
• 支払いなしでリクエストを送信して 402 の内容を読み取り、有料の呼び出しにかかる料金を確認します。

実際の出力：

free answer: HTTP 402 (Payment Required) is a non-standardized status code reserved for future use...
web-search costs 0.01 USDC on eip155:8453 (HTTP 402)

2. 有料：1回の呼び出し、1回の署名

PRIVATE_KEY=0x... npm run paid

支払い処理は次の3行です。この後は通常の fetch です。

const signer = toClientEvmSigner(wallet);
const client = new x402Client().register('eip155:8453', new ExactEvmScheme(signer));
const fetchWithPay = wrapFetchWithPayment(fetch, client);

秘密鍵はご使用のマシンに保管されます。サーバーに渡るのは、署名済みの支払い情報だけです。 USDC で Base、Polygon、Arbitrum、Solana 上で決済されます。エラーレスポンスに料金はかかりません。

上の無料の例は、そのまま実行したものです。有料の例を実行するには、ご自身で資金を入れたウォレットが必要です。 少額を入金してご自身で実行してください。この例では、当社のサービスで使用しているものと同じクライアントを使用します。

3. MCP クライアントを接続する

リモート（無料ツールのみ。リモートサーバーがユーザーのウォレットを保持することはありません）：

https://agents.dexl.io/mcp

ローカル（ウォレットをマシン上に保管するため、有料ツールも利用できます）：

{
  "mcpServers": {
    "dexl": {
      "command": "npx",
      "args": ["-y", "dexl-agents", "mcp"],
      "env": { "DEXL_BASE_URL": "https://agents.dexl.io", "DEXL_PRIVATE_KEY": "<optional>" }
    }
  }
}

呼び出せるもの

GET /v1/tools には、すべてのツールの料金とスキーマが一覧表示されます。 機械可読な情報：/llms.txt · /openapi.json · /.well-known/x402 · /.well-known/mcp

MIT ライセンスです。問題の報告やプルリクエストを歓迎します。