Agent Kiosk — 23-in-1 B2A Intelligence, Action & x402 API

Agent Kiosk——面向自主 Agent 的 24 合 1 B2A 智能、行动与合规超市（x402 v2 与 MCP）

Agent Kiosk 是一个即时按次付费的 API 和模型上下文协议（MCP）服务，专为在 Base 主网（eip155:8453） 上运行的自主 AI Agent、交易机器人、编码助手和研究工作流打造。所有付费和预付费响应均包含加密的 SHA-256 + HMAC-SHA256 attestation 信封（attested 标签）。

• 生产环境 Base URL： https://agent-kiosk.vercel.app
• 商户收款地址（payTo）： 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95（Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913，6 位小数）
• 目录范围： 24 个受 x402 保护的端点（23 个按次付费端点 + 1 个预付费 30 天 API 通行证），以及免费的发现、遥测、MCP 预览和合作伙伴费用兑换路由
• 实时遥测与钱包仪表板： https://agent-kiosk.vercel.app/stats（GET /v1/stats JSON）
• MCP 端点： https://agent-kiosk.vercel.app/mcp（https://agent-kiosk--batuhansenavci.run.tools）
• x402scan 商店（24/24 已验证）： x402scan.com/server/a1af2789-615a-4324-b3f1-83b97834ece8
• Glama MCP 列表： glama.ai/mcp/servers/ralf9090/agent-kiosk
• Smithery 商店： smithery.ai/servers/batuhansenavci/agent-kiosk

---

1. 统一路由、方法与价格目录

A. 23 个按次付费的 x402 端点（Base USDC eip155:8453）

所有 /v1/* 路由均接受 POST（主要使用 JSON 请求体）和 GET（查询参数）。未经身份验证的请求会返回 HTTP 402 Payment Required，并附带 PAYMENT-REQUIRED 标头。

#	MCP 工具	x402 REST 路由	方法	价格（USDC）	原子单位（6 位小数）	描述
1	x402_ping	/v1/ping	POST / GET	$0.001	1000	即时 x402 v2 和 v1 钱包验证 ping、结算检查及往返回显。
2	llm_chat_completions	/v1/chat/completions	POST / GET	$0.002	2000	兼容 OpenAI 的 LLM Chat Completions 网关（gpt-4o-mini、openai、deepseek-chat）。
3	evm_tx_simulator	/v1/tx-simulate	POST / GET	$0.005	5000	EVM 交易预执行模拟器（eth_call + eth_estimateGas）、回滚解码器、ERC-20 allowance 和 EIP-1967 代理检测器。
4	perp_funding_arbitrage	/v1/funding-rates	POST / GET	$0.008	8000	跨交易所永续合约资金费率套利、基差年化收益率利差及未平仓量雷达（Hyperliquid + dYdX v4）。
5	tradfi_macro_radar	/v1/macro-radar	POST / GET	$0.008	8000	实时追踪标普 500、纳斯达克、VIX、DXY、美国 10 年期国债收益率、黄金、石油、加密货币恐惧与贪婪指数、BTC 市值占比及 DeFi TVL。
6	web_extract	/v1/web-extract	POST / GET	$0.01	10000	将 URL 清理并提取为 Markdown，同时检测提示词注入陷阱。
7	package_audit	/v1/package-audit	POST / GET	$0.01	10000	通过 Google OSV.dev 扫描开源软件包及 CVE 漏洞（npm、PyPI、crates.io）。
8	github_intel	/v1/github-intel	POST / GET	$0.01	10000	GitHub 仓库及开源竞争情报：星标数、发行版本、议题及热门主题。
9	kalshi_polymarket_arb	/v1/prediction-arb	POST / GET	$0.015	15000	整合 Kalshi、Polymarket 和 Manifold 预测市场，并扫描跨平台概率价差。
10	social_search	/v1/social-search	POST / GET	$0.02	20000	实时获取 Reddit 和 HackerNews 讨论，提供整洁的 JSON 和 Markdown 格式。
11	security_audit	/v1/security-audit	POST / GET	$0.02	20000	0x 代币/合约貔貅盘及税费扫描（GoPlus + DexScreener），并审计 URL 钓鱼风险。
12	token_alpha	/v1/token-alpha	POST / GET	$0.02	20000	实时 DEX 订单流（买卖压力）、流动性深度及动量信号。
13	domain_intel	/v1/domain-intel	POST / GET	$0.02	20000	B2B 公司及域名情报：DNS、MX 邮件服务商、SaaS TXT 技术栈、RDAP 及子域名。
14	academic_search	/v1/academic-search	POST / GET	$0.02	20000	检索经同行评审的科学文献（OpenAlex + arXiv），并提供摘要和 PDF 链接。
15	prediction_markets	/v1/prediction-markets	POST / GET	$0.02	20000	获取 Polymarket 和 Manifold Markets 的实时事件概率（%）及投注量。
16	defi_yields	/v1/defi-yields	POST / GET	$0.02	20000	由 DeFiLlama 提供的 DeFi 最高 APY 和收益雷达，可按代币、链和 TVL 筛选。
17	maps_leads	/v1/maps-leads	POST / GET	$0.03	30000	按城市筛选 B2B 商业线索，包含电话、网站、电子邮件、地址及 GPS。
18	wallet_profiler	/v1/wallet-profiler	POST / GET	$0.03	30000	多链巨鲸及钱包画像（Base、Ethereum、Arbitrum、Polygon）：USDC/ETH 余额及交易数量。
19	compliance_check	/v1/compliance-check	POST / GET	$0.05	50000	**反洗钱、制裁（OFAC）及交易对手筛查：**在 Base 和 Ethereum 上检查 14 类风险指标（钓鱼、Tornado Cash 混币器、貔貅盘创建者、暗网、网络犯罪）。
20	defi_swap_quote	/v1/defi-swap-quote	POST / GET	$0.05	50000	**可执行 DeFi 兑换及跨链桥调用数据构建器：**提供最佳 DEX 路由（LI.FI + ParaSwap）及可直接签名的 EVM transactionRequest（to、data、value、gasLimit）。
21	token_due_diligence	/v1/token-due-diligence	POST / GET	$0.10	100000	**机构级代币三合一评估：**GoPlus 合约审计 + DEX 订单流 + 社交情绪（A–F 等级）。
22	b2b_company_dossier	/v1/b2b-company-dossier	POST / GET	$0.10	100000	**B2B 高管四合一档案：**DNS/SaaS 技术栈 + 网站抓取 + 本地线索 + 社交提及。
23	whale_alpha_radar	/v1/whale-alpha-radar	POST / GET	$0.10	100000	**巨鲸投资组合及收益三合一优化器：**4 链钱包画像 + DeFi 高收益机会 + 宏观赔率。

B. 1 预付费 30 天 API 通行证端点（Base USDC eip155:8453）

#	MCP 工具	x402 REST 路由	方法	价格（USDC）	原子单位（6 位小数）	描述
24	buy_prepaid_pass	/v1/buy-pass	POST / GET	$5.00	5000000	**30 天预付费 VIP API 密钥（ak_live_...）：**生成无状态 HMAC-SHA256 签名 API 密钥，可通过 X-API-KEY 或 Authorization: Bearer 解锁全部 23 个按次付费端点，有效期为 30 天，无需为每次调用进行 x402 签名。

C. 免费 / 未付费路由（$0.00 USDC — 无需 x402 付款即可返回 HTTP 200）

路由	方法	价格	用途
/v1/free-swap	POST / GET	$0.00	无付费墙的可执行 DEX 兑换和跨链桥 calldata 构建器（通过向 payToWallet 支付 0.25% 的链上合作方费用实现变现）。
/v1/models	GET	$0.00	兼容 OpenAI 的模型列表发现（gpt-4o-mini、openai、deepseek-chat）。
/mcp	POST / GET	$0.00（预览）/ 付费（完整内容）	Streamable-HTTP MCP JSON-RPC 2.0 服务（列出全部 24 个工具；未经身份验证的 tools/call 返回 HTTP 200 和 1 项预览，以及 x402_unlock_full_data 挑战；x402_ping 和 defi_swap_quote 返回完整预览数据；在工具参数中传入 payment_signature 或 x_api_key 可返回未屏蔽的完整数据）。
/v1/stats、/stats	GET	$0.00	实时 JSON 和 HTML 服务漏斗遥测数据，以及链上 Base USDC 钱包余额仪表板。
/.well-known/x402.json	GET	$0.00	机器可读的 x402 v2 目录、facilitator 配置和路由明细（/.well-known/x402 和 /.well-known/agent.json 均为其别名）。
/.well-known/agent-card.json	GET	$0.00	带有 a2a-x402 扩展的 Google A2A v0.3.0 Agent Card。
/.well-known/mcp.json	GET	$0.00	MCP 服务清单（24 个工具、4 个提示词、3 个资源）。
/openapi.json	GET	$0.00	涵盖全部 24 个 x402 端点的 OpenAPI 3.1.0 规范。
/llms.txt、/llms-full.txt	GET	$0.00	便于大模型读取的发现目录、买方集成指南和完整输入架构。

---

2. 生产环境 x402 买方指南与 Facilitator 集成

A. Base Mainnet 结算服务商（我们是卖方，而非服务商）

Agent Kiosk 使用 src/x402.js 中配置的多服务商故障转移流程，验证并结算 Base Mainnet (eip155:8453 / base) 上收到的 EIP-3009 (TransferWithAuthorization) USDC 签名：

角色	服务商名称	API 基础 URL	支持的端点	验证端点	结算端点	支持的版本与方案	服务商签名者／中继者地址（非商户地址）
主要	PayAI Network	https://facilitator.payai.network	GET https://facilitator.payai.network/supported	POST https://facilitator.payai.network/verify	POST https://facilitator.payai.network/settle	x402 v2 (eip155:8453，exact) 和 x402 v1 (base，exact)，无需 API 密钥	0xB2Bd29925CBbCEA7628279c91945Ca5B98bf371B、0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63（以及 /supported 中 signers["eip155:*"] 列出的池签名者）
次要备用	Dexter	https://facilitator.dexter.cash	GET https://facilitator.dexter.cash/supported	POST https://facilitator.dexter.cash/verify	POST https://facilitator.dexter.cash/settle	x402 v2 (eip155:8453，exact) 和 x402 v1 (base，exact)	0x402Feee072D655B85e08f1751AF9ddbCd249521f
第三备用（v1）	Mogami	https://facilitator.mogami.tech	GET https://facilitator.mogami.tech/supported	POST https://facilitator.mogami.tech/verify	POST https://facilitator.mogami.tech/settle	x402 v1 (base，exact)	公开的 v1 中继者池

• 商户收款地址（payTo）： 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95（Base Mainnet 上的 USDC：0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913，6 位小数）。

B. 接受的支付、质询与回执标头

方向	标头／参数	协议	格式与说明
HTTP 402 响应	PAYMENT-REQUIRED	x402 v2	Base64 编码的 JSON PaymentRequired 质询（x402Version: 2，accepts[0] 包含 scheme: "exact"、network: "eip155:8453"、amount、maxAmountRequired、asset、payTo、maxTimeoutSeconds: 60、extra: { name: "USD Coin", version: "2" }）。相同的 JSON 对象也会作为 HTTP 402 响应正文返回。
HTTP 请求（按调用付费）	PAYMENT-SIGNATURE	x402 v2	Base64、Base64URL 或原始 JSON 字符串，内容为 { x402Version: 2, scheme: "exact", network: "eip155:8453", payload: { signature, authorization: { from, to, value, validAfter, validBefore, nonce } } }。
HTTP 请求（旧版／别名）	X-PAYMENT 或 X-PAYMENT-SIGNATURE	x402 v1 / v2	接受 x402 v1（network: "base"）以及使用 X-PAYMENT 或 X-PAYMENT-SIGNATURE 发送支付标头的 v2 客户端。
HTTP 请求（预付通行证）	X-API-KEY 或 Authorization: Bearer <key>	预付通行证	传入通过 POST /v1/buy-pass（$5.00 USDC）签发的 ak_live_<payloadB64>.<sigB64> 通行证，即可在 30 天内访问 23 个付费端点，无需逐次签名。
MCP tools/call 参数	payment_signature、x_payment 或 x_api_key	基于 HTTP / stdio 的 MCP	在 POST /mcp 的 params.arguments 中直接传入 x402 支付载荷或 ak_live_... 密钥，即可在 MCP 客户端中解锁完整的未屏蔽数据。
HTTP 200 响应（回执）	PAYMENT-RESPONSE 和 X-PAYMENT-RESPONSE	x402 v2 和 v1	服务商返回的 Base64 编码 JSON 结算回执：{"success":true,"transaction":"0x...","network":"eip155:8453","payer":"0x..."}。链上交易哈希也会作为 tx_hash 回显在 HTTP 200 JSON 正文中。

C. 超时、不确定的结算状态与恢复说明

1. 服务端与挑战超时：
   • 每个 402 Payment Required 挑战都指定 maxTimeoutSeconds: 60。买家应使用 validAfter = 0 且 validBefore >= now + 300 秒的值签署 EIP-3009 TransferWithAuthorization 消息。
   • 服务端对每个 facilitator 的 POST /verify 调用强制执行 6.5 秒超时，对每个 facilitator 的 POST /settle 调用强制执行 10.0 秒超时。
   • 如果主 facilitator（facilitator.payai.network）在 /verify 或 /settle 上返回 HTTP/网络错误，中间件会自动故障转移到下一个已配置的 facilitator（facilitator.dexter.cash）。如果签名在密码学上无效（invalid_exact_evm_signature），服务端会立即返回 HTTP 402 和确切的错误原因，不会重试。
2. 处理不确定的结算状态（客户端超时／网络中断）：
   • 每个 EIP-3009 TransferWithAuthorization 都使用唯一的 32 字节 nonce。在 Base Mainnet 上使用后，USDC 合约（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）会永久将该 (authorizer, nonce) 对标记为已使用（AuthorizationUsed 事件），因此链上不可能重放或重复扣取同一签名。
   • 超时情况下买家须遵循的规则： 如果发送 PAYMENT-SIGNATURE 后 HTTP 请求超时或断开连接，请勿立即签署新的 nonce：
     1. 通过 authorizationState(address authorizer, bytes32 nonce)（0xe94a0102）查询 Base USDC（0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913），或查看 https://basescan.org/address/0xd8429209Aee6A398B9707DFf5F28AAA93452eE95#tokentxns。
     2. 如果 authorizationState 为 false（尚未在链上结算）： 可以使用完全相同的 PAYMENT-SIGNATURE 标头（相同的 nonce）安全地重试请求，直至 validBefore 过期；也可以等到 validBefore 过期后再签署新的 nonce。
     3. 如果 authorizationState 为 true（已在链上结算，但 HTTP 响应在传输过程中丢失）： 请在 github.com/ralf9090/agent-kiosk/issues 提交 issue，并附上 Base txHash、端点路径和时间戳，以便立即重放响应，或获得免费的预付 API 通行证额度。

---

3. 已验证的 Base Mainnet 结算证据（运营方测试）

披露： 以下交易是在生产环境部署（https://agent-kiosk.vercel.app）上执行的运营方测试付款，并通过 PayAI Network facilitator（https://facilitator.payai.network/settle）在 Base Mainnet（eip155:8453） 上结算；这些交易不属于第三方客户交易量。

示例 1 — POST https://agent-kiosk.vercel.app/v1/token-alpha（0.02 USDC / 20000 个最小单位）

• 端点与方法： POST https://agent-kiosk.vercel.app/v1/token-alpha
• 结算金额： 0.02 USDC（20000 个最小单位，Base USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）
• Base Mainnet 交易链接： https://basescan.org/tx/0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be（区块 52809684，状态：Success）
• Facilitator 中继者（链上 from）： 0xc6699d2aadA6c36Dfea5C248DD70f9CB0235cB63（PayAI Network 中继者）
• 卖家收款方（payTo）： 0xd8429209Aee6A398B9707DFf5F28AAA93452eE95

解码后的 PAYMENT-RESPONSE / X-PAYMENT-RESPONSE 标头：

{
  "success": true,
  "transaction": "0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be",
  "network": "eip155:8453",
  "payer": "0xd8429209aee6a398b9707dff5f28aaa93452ee95"
}

已编辑的 HTTP 200 资源响应（POST /v1/token-alpha，请求体为 {"query":"AERO","chain":"base"}）：

{
  "ok": true,
  "payment_mode": "x402",
  "tx_hash": "0x5aa1b42ef7dae5323ba561b9374e9e5db0d42b0eae23d7e4fc5c2f0929df61be",
  "attestation": {
    "attested": true,
    "issuer": "io.github.ralf9090/agent-kiosk",
    "signer_wallet": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "algorithm": "HMAC-SHA256",
    "route": "/v1/token-alpha",
    "payload_sha256": "c1bcebf107e25a742a7afc58ca39692bc33f4e6da49a2ca1afc8b892fae63a1f",
    "timestamp_utc": "2026-10-19T11:18:33.296Z",
    "signature": "<REDACTED_ATTESTATION_HMAC>"
  },
  "data": {
    "query": "AERO",
    "found": true,
    "token": {
      "name": "Aerodrome",
      "symbol": "AERO",
      "address": "0x940181a94A35A4569E4529A3CDfB74e38FD98631",
      "primary_chain": "base",
      "price_usd": 0.7866,
      "market_cap_usd": 789632423,
      "fdv_usd": 1575158274
    },
    "alpha_metrics": {
      "signal": "SELL_PRESSURE",
      "total_top5_liquidity_usd": 47963273,
      "volume_1h_usd": 403817,
      "volume_24h_usd": 12606349,
      "order_flow_1h": { "buys": 88, "sells": 495, "buy_pressure_pct": 15.1 },
      "order_flow_24h": { "buys": 3508, "sells": 13997, "buy_pressure_pct": 20 }
    },
    "llm_summary": "Aerodrome (AERO on base): $0.7866 | Signal: SELL_PRESSURE | 1h Buy Pressure: 15.1% (88 buys vs 495 sells) | Liquidity: $47,963,273 | 24h Vol: $12,606,349."
  }
}

示例 2 — POST https://agent-kiosk.vercel.app/v1/ping（0.001 USDC / 1000 个原子单位）

• 端点与方法： POST https://agent-kiosk.vercel.app/v1/ping
• 结算金额： 0.001 USDC（1000 个原子单位）
• Base 主网交易链接： https://basescan.org/tx/0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e（区块 52809683，状态：Success）
• 结算方中继器（链上 from）： 0xB2Bd29925CBbCEA7628279c91945Ca5B98bf371B（PayAI Network 中继器）

解码后的 PAYMENT-RESPONSE / X-PAYMENT-RESPONSE 标头：

{
  "success": true,
  "transaction": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e",
  "network": "eip155:8453",
  "payer": "0xd8429209aee6a398b9707dff5f28aaa93452ee95"
}

已脱敏的 HTTP 200 资源响应（POST /v1/ping，请求体为 {"message":"x402-registry-verification"}）：

{
  "ok": true,
  "payment_mode": "x402",
  "tx_hash": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e",
  "attestation": {
    "attested": true,
    "issuer": "io.github.ralf9090/agent-kiosk",
    "signer_wallet": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "algorithm": "HMAC-SHA256",
    "route": "/v1/ping",
    "payload_sha256": "6fc2d484b7899b71b18d80b87c18230e8904e7f296ca3c471763cc618a932041",
    "timestamp_utc": "2026-10-19T11:18:31.280Z",
    "signature": "<REDACTED_ATTESTATION_HMAC>"
  },
  "data": {
    "status": "pong",
    "verified": true,
    "payment_mode": "x402",
    "service": "Agent Kiosk",
    "version": "2.6.0",
    "protocol": "x402 v2 & v1 + MCP (Attested)",
    "network": "eip155:8453",
    "asset": "USDC",
    "echo": "x402-registry-verification",
    "payer": "0xd8429209Aee6A398B9707DFf5F28AAA93452eE95",
    "tx_hash": "0xd4869a2190887c15b9fb53c109045fe60bb6bef6a3cf8b66e6f7e0a9904fda7e"
  }
}

---

4. 快速连接（Claude Desktop / Cursor / Windsurf / VS Code）

{
  "mcpServers": {
    "agent-kiosk": {
      "url": "https://agent-kiosk.vercel.app/mcp"
    }
  }
}