给加密开发者、交易者、协议方用的链上情报服务:这个地址是谁?这笔交易做了什么?这组地址是不是同一伙人?
| 接口 | 作用 | 价格 |
|---|---|---|
GET /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. | 1 credit |
GET /v1/explain/{txHash} | Plain-language explanation of a Base transaction: what happened, who paid whom, which contracts were involved. | 2 credits |
GET /v1/cluster/{funder} | Sybil / funding-cluster analysis: addresses funded by the same funder on Base. | 5 credits |
GET /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. | 3 credits |
GET /v1/alerts | Historical on-chain alerts on Base (filter by address / kind / severity / since). | 1 credit |
GET /v1/alerts/stats | Aggregate statistics over historical on-chain alerts on Base. | 1 credit |
POST /v1/alerts/subscribe | Subscribe an agent to future on-chain alerts on Base, delivered via webhook or Telegram. | 1 credit |
GET /api/filings/8k | Latest US SEC 8-K material-event filings (M&A, executive changes, earnings, delisting, bankruptcy). Live stream from SEC EDGAR. | 1 credit |
GET /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. | 1 credit |
GET /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. | 1 credit |
| 完整 OpenAPI 规范 · llms.txt(供 LLM agent 直读) | ||
USDC 充值,1 USDC = 100 credits(label 查询约 $0.01/次)。
无需注册、无需付款:用你的 Base 钱包地址作为 Bearer 身份首次调用即自动获得 10 credits 的免费额度,够跑通 10 次地址查询。额度用完后接口返回 402 Payment Required 并附充值指引。
两套免费额度互相独立:钱包试用需带 Bearer 身份,每地址一次性 10 credits;匿名免费层只走 MCP、无需任何身份,按 IP 与工具分别计数,用来先跑通一次调用。
curl -H "Authorization: Bearer <你的地址或API key>" \ https://agentsapi.top/v1/label/0x0000000000001ff3684f28c67538d4d072c22734
发送 USDC(Base 主网)到收款地址 0x381cdbb664608bf7b1dd4f9403a572c1c57332c2,并用同一个地址作为 Bearer 身份调用——链上监听确认到账后约 1 分钟自动入账。
程序化发现:/.well-known/x402(x402 定价 manifest)。
同一套能力也以远程 MCP server 对外提供:https://agentsapi.top/mcp(Streamable HTTP,serverInfo.version 0.3.1,共 7 个工具)。握手与 tools/list 免费;匿名免费层 7 次/日/IP(全站上限 500/日;每个工具各 1 次,共 7 个工具都可试:get_label / explain_transaction / detect_cluster / query_alerts / alert_stats / track_cctp / list_paid_endpoints),无需注册、无需钱包;tools/call 按次计费(x402 payment-signature 或 Bearer/credit),与上方 REST 端点共用同一份定价与收款地址。
机器可读入口:/mcp 端点卡片 · /skill.md agent 使用说明 · /.well-known/mcp.json · mcp-server-card.json · /statusz 实时状态
启用 x402 的部署下,agent 客户可直接在请求头带 X-PAYMENT 按次自动付款(USDC 经 CDP Facilitator 校验,落到上面的收款地址),无需先充值、无最低余额。端点已被 /.well-known/x402 暴露,可被 Agentic.Market 等 agent 市场自动发现与调用。