# agentsapi.top — AI Agent 付费 API（x402 按次支付，USDC on Base）

> 机器客户无需注册：直接调用付费端点，x402 自动完成签名-支付-重试循环。
> 完整机器可读接口文档（OpenAPI）：https://agentsapi.top/openapi.json （含全部 10 个付费端点）
> x402 付款要求（PayTo / Facilitator / pricing）：https://agentsapi.top/.well-known/x402
> 付费端点清单：
  - GET https://agentsapi.top/v1/label/{address} — Address tag lookup on Base: 104,209 entries from the open eth-labels dataset, mostly category tags (79.8% generic such as token-contract/stablecoin/burn, 18.7% exchange) rather than named entities. Unknown addresses return label:null and are still charged per call; measured hit rate on real inbound requests was 37.5% of unique addresses. Pay per call with USDC via x402.（$0.01/次）
  - GET https://agentsapi.top/v1/explain/{txHash} — Plain-language explanation of a Base transaction: what happened, who paid whom, which contracts were involved.（$0.02/次）
  - GET https://agentsapi.top/v1/cluster/{funder} — Sybil / funding-cluster analysis: addresses funded by the same funder on Base.（$0.05/次）
  - GET https://agentsapi.top/v1/track/cctp/{txHash} — CCTP cross-chain USDC tracking: given the source-chain tx hash, returns burn/mint status and whether funds arrived on Base.（$0.03/次）
  - GET https://agentsapi.top/v1/alerts — Historical on-chain alerts on Base (filter by address / kind / severity / since).（$0.01/次）
  - GET https://agentsapi.top/v1/alerts/stats — Aggregate statistics over historical on-chain alerts on Base.（$0.01/次）
  - POST https://agentsapi.top/v1/alerts/subscribe — Subscribe an agent to future on-chain alerts on Base, delivered via webhook or Telegram.（$0.01/次）
  - GET https://agentsapi.top/api/filings/8k — Latest US SEC 8-K material-event filings (M&A, executive changes, earnings, delisting, bankruptcy). Live stream from SEC EDGAR.（$0.01/次）
  - GET https://agentsapi.top/api/filings/today — Today’s US SEC 8-K material-event filings (M&A, executive changes, earnings, delisting, bankruptcy), newest first. Same SEC EDGAR live stream as /api/filings/8k, fixed at the 50 most recent filings.（$0.01/次）
  - GET https://agentsapi.top/v1/label — Address tag lookup on Base: 104,209 entries from the open eth-labels dataset, mostly category tags (79.8% generic such as token-contract/stablecoin/burn, 18.7% exchange) rather than named entities. Unknown addresses return label:null and are still charged per call; measured hit rate on real inbound requests was 37.5% of unique addresses. Pay per call with USDC via x402.（$0.01/次）

> MCP 端点（streamable-http，无需 SDK）：https://agentsapi.top/mcp
> 调用方式：POST JSON-RPC 2.0；initialize 与 tools/list 免费且不占额度，tools/call 计费。
> 匿名免费额度：7 次/日/IP（每个工具各 1 次，覆盖 7 个工具），无需注册、无需钱包。
> 付费方式：收到 402 后向 payTo 0x381cdbb664608bf7b1dd4f9403a572c1c57332c2 转 USDC（Base），再以同一地址作 Bearer 重试。
> MCP 工具与单价（credits，100 credits = 1 USDC）：
  - mcp:get_label — 1 credits（$0.01/次）
  - mcp:explain_transaction — 2 credits（$0.02/次）
  - mcp:detect_cluster — 5 credits（$0.05/次）
  - mcp:query_alerts — 1 credits（$0.01/次）
  - mcp:alert_stats — 1 credits（$0.01/次）
  - mcp:track_cctp — 3 credits（$0.03/次）
  - mcp:list_paid_endpoints — 1 credits（$0.01/次）
> MCP server version: 0.3.1（与 initialize.serverInfo.version 同源）
> 机器可读入口：https://agentsapi.top/mcp · https://agentsapi.top/.well-known/mcp.json · https://agentsapi.top/skill.md