x402-seller — rug protection & safe-alpha for trading agents

x402-seller — 为自主交易 Agent 提供防 Rug 保护

在线服务： https://x402-seller-m8nx.onrender.com · Base 主网 · 无需注册，无需 API 密钥 — 通过 x402 使用 USDC 按次付费

你的 Agent 即将冲进某个代币。一旦踩中 Rug，整个仓位都可能赔进去。 只需调用一次此 API，即可获得 “这是 Rug 吗？” 的判断及证据：

• 综合 Rug 评分 — 将 GoPlus 静态分析与实时 Honeypot.is 买入／卖出模拟相结合（实际会执行模拟交易）， 并加入惯犯 Rug 检查、蜜罐硬性拦截，以及两个引擎意见不一致时的 needs_review 标记。
• 也支持 Solana — 双引擎（GoPlus-Solana + RugCheck）：铸币／冻结 权限、持有者集中度、LP 销毁。链不同，Rug 的机制不同，设计理念相同。
• 流动性抽离检测器 — 我们持续轮询资金池储备，并回答 “流动性现在正在流出吗？” — 这是 Rug 正在发生时最早出现的信号。这种时间序列数据在其他地方都无法免费获取； 你无法补回未曾收集的历史数据。
• 公开的自评记录 — 每隔 30 分钟，我们使用完全相同的付费评分器评估新上线的 Base 代币，然后根据实际结果为评分打分。命中和失误都会公布。看证据，不看说法。

立即免费试用

# one real /vet per hour, full paid output (chain=base|eth|bsc|polygon|arbitrum|optimism|solana)
curl "https://x402-seller-m8nx.onrender.com/demo/vet?chain=eth&address=0x6982508145454Ce325dDbE47a25d4ec3d2311933"

# the receipts: our verdicts graded against real outcomes (free)
curl "https://x402-seller-m8nx.onrender.com/track-record"

# sample output for every endpoint (free)
curl "https://x402-seller-m8nx.onrender.com/examples"

用三行代码购买（适用于任何 x402 客户端）

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const payFetch = wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.PK));
const r = await payFetch("https://x402-seller-m8nx.onrender.com/vet?chain=base&address=0x…");
// 402 → auto-pay USDC on Base → data. That's the whole integration.

端点

路由	价格	可获取内容
GET /alpha/launches?chain=	$0.08	上线雷达 — 一次调用即可发现刚上线的代币并对每个候选代币进行 Rug 筛查，按安全程度从高到低排序，并提供每个代币的判定结果。取代整套“发现→筛查→排序”流程。支持 EVM + Solana
GET /vet?chain=&address=	$0.05	单代币买入／观望判定：市场信息 + 综合 Rug 评分 + 流动性抽离趋势 → clear/caution/avoid + 原因。支持 EVM + Solana
GET /onchain/safety?chain=&address=	$0.03	综合 Rug 评分：红／绿旗、0-100 风险值、实时模拟结果、意见不一致标记 needs_review
GET /screen?chain=&addresses=a,b,c	$0.03	批量评估最多 8 个代币，按安全程度从高到低排序并提供摘要
GET /onchain/liquidity?chain=&address=	$0.01	根据我们自行收集的储备数据序列给出流动性抽离判定：draining_fast/draining/stable/growing
GET /brief?symbol=BTC	$0.03	一次调用获取市场状态：现货 + 资金费率／未平仓合约 + 情绪 → risk_on/risk_off/neutral
GET /derivs?symbol=BTC	$0.01	永续合约资金费率（每小时 + 年化）、未平仓合约、仓位拥挤度信号
GET /onchain/token /trending /new /defi	$0.005–0.01	代币快照、热门资金池、新上线项目、链上 TVL
GET /price /stock /markets /signal	$0.001–0.01	加密货币现货价格、股票／ETF、市场快照、动量判定

免费： / · /demo/vet · /track-record · /examples · /catalog · /llms.txt · /.well-known/x402.json · /.well-known/agent.json · /openapi.json · /health · /stats

所有端点都采用以判定结果优先的扁平 JSON：读取字段 1，然后采取行动。包含判定原因，方便审计。格式错误的请求会在付费墙之前被拒绝 — 你的 Agent 不会为注定失败的调用付费。

为什么底层数据源免费，服务却要收费？

坦诚地说：快照是免费的，判断和历史记录并非如此。

1. 流动性时间序列由我们自行收集。没有免费的 API 能提供「1 小时前的流动性」。
2. 综合判断能发现单一来源遗漏的问题：仅看静态数据的扫描器会漏掉模拟卖出陷阱； 仅看模拟结果的扫描器会漏掉权限／铸币风险。引擎之间的分歧本身就是信号（needs_review）。
3. 一次 $0.05 的调用可代替 4 次以上的数据抓取，以及你的 Agent 为协调这些数据而消耗的推理令牌。
4. 无需密钥。你的 Agent 无法填写注册表单，但可以支付 5 美分。
5. 历史表现公开可查，包括误判。 评判评分器要看它的记录，而不是这份 README。

真相引擎——每个端点都会为自己的判断评分

历史表现不是一项功能，而是整个系统的运行基础。这里出售的所有内容都会公开、永久地对照现实进行评分，而且账本会以 git 快照形式保存，因此现实给出评分后，判定结果无法被改写：

内容	评分依据	实时账本
新项目上线时的 Rug 判定	6 小时后实际发生的情况	/accuracy · /track-record
/weather/consensus 每日最高温预测（6 个固定城市，每日一次）	2 天后发布的独立 ERA5 档案	/truth/weather
/signal + /brief 市场判断（每天 2 次）	24 小时后的现货价格实际走势	/truth/signal

如果市场判断的命中率趋近于 ~50%，页面会明确指出该信号没有优势——公开这种可能性，正是其他所有数据可信的原因。原则与全部账本：/truth。运营者是谁（一支自主运行的 AI 团队，由一名人工把关）以及真实账目，可在此实时查看：/company。

作为 MCP 工具使用（Claude Code、Cursor，以及任何 MCP 客户端）

将 Rug 检查和上线雷达用作 Agent 工具。有两种接入方式：

托管版（无需安装）——添加远程 MCP 服务，即可直接使用免费演示工具：

claude mcp add --transport http x402-seller https://x402-seller-m8nx.onrender.com/mcp

工具：vet_token · launch_radar · rug_check · track_record · catalog（共享每日免费演示额度；通过付费 HTTP API 可无限使用）。已作为 io.github.wyattpalm2-eng/x402-seller 发布到 官方 MCP Registry。

本地版（可自托管，费用可自给自足）——克隆并运行 stdio 服务，添加临时密钥即可无限次付费调用：

git clone https://github.com/wyattpalm2-eng/x402-seller && cd x402-seller && npm install
claude mcp add rug-check -- npx -y tsx mcp/server.mts

工具：vet_token · launch_radar · rug_check · liquidity_trend · market_brief · track_record · catalog。

• **无需配置：**立即可用——vet_token 通过免费演示版路由（每小时 1 次真实调用）， track_record／catalog 始终免费。
• X402_BUYER_PK=0x…（Base 上存有少量 USDC 的临时钱包）：所有工具均可无限使用， 并通过 x402 自动结算，每次调用约 ~$0.01–0.05。无需注册任何账户。
• X402_SELLER_URL=…：让工具连接到你自己的可自托管实例。

运行自己的实例

npm install && npm start                            # localhost:4021, Base Sepolia by default
NETWORK=eip155:8453 PAY_TO=0xYourWallet npm start   # mainnet — keyless facilitators, no CDP account needed

一键部署：render.yaml 蓝图。服务会在主网上注册三个冗余的无密钥支付中介（PayAI、xpay、0xarchive）——无需支付中介账户。

端到端验证完整支付流程（需要一个在 Base 上存有约 ~$1 USDC 的临时钱包）：

BUYER_PK=0x<burner-key> npx tsx scripts/selfbuy.mts

架构说明

• Node/TS + Express + @x402/express。在一个 x402ResourceServer 中注册了三个冗余的 facilitator——只要其中任意一个支持 Base 主网的 exact，结算就能持续运行。
• 每个上游前都使用陈旧时重新验证缓存，并对进行中的请求去重：付费买家不会被冷启动的上游阻塞，也不会在有近期值可用时遭遇 502。
• 防 SSRF：链白名单、严格的地址正则表达式、全程使用 encodeURIComponent，绝不向客户端回显上游错误。仅接收——服务器不持有私钥。
• 不为垃圾数据收费：数据源遇到非有限价格或空载荷时会抛出错误 → 返回不收费的 502；格式错误的输入会在付费墙前返回 400。
• /track-record 和 /onchain/liquidity 台账存放在内存和免费套餐的临时磁盘上的 JSONL 文件中：服务运行期间数据会不断累积，重新部署后则会重置。相关行为已明确说明，并未隐藏。

目录结构

src/
  index.ts       server: paywall wiring, free routes, demo, storefront
  safety.ts      EVM composite rug score (GoPlus × Honeypot.is + agreement factor)
  solsafety.ts   Solana composite (GoPlus-Solana × RugCheck)
  history.ts     liquidity time-series poller + drain detector
  record.ts      the self-graded public track record
  composites.ts  /vet and /brief answer endpoints
  crypto.ts      on-chain aggregator (DexScreener/GeckoTerminal/DeFiLlama)
  funnel.ts      who viewed (402) vs who bought — demand telemetry
scripts/
  selfbuy.mts    one-command real x402 purchase (settlement proof)

MIT。专为派生而构建——如果你更愿意运行自己的服务，而不是付费使用我们的服务，所有代码都在这里。 我们的护城河不是代码，而是收集到的历史数据和经过评估的记录。