tech-risk

Grey Ridge Signals — 面向 Agent 的 x402 数据与安全 API

通过 x402 支付协议在 Base 主网上，为 AI Agent 提供按次付费的加密货币、DeFi、预测市场和链上数据，以及 MCP 安全扫描。

无需账户、API 密钥或订阅。Agent 可直接在请求中使用 USDC 付款（每次调用低至 $0.001），并在同一请求中获取数据。每个数据端点都提供免费预览，让 Agent 先查看数据内容再决定是否付费。

• 基础 URL： https://x402-data-api.sigrunner.workers.dev
• MCP 端点（streamable-http）： https://x402-data-api.sigrunner.workers.dev/mcp
• 规范域名： https://x402-data-api.sigrunner.workers.dev（同一 API）
• 发现： /.well-known/x402 · /openapi.json · /llms.txt
• 网络： Base 主网（eip155:8453），USDC。通过非托管式 xpay 促进器结算——无需 Coinbase/CDP 账户。也已列入 CDP x402 Bazaar。

---

两大旗舰功能——Agent 实际付费使用的服务

1. MCP 服务安全扫描（/scan/mcp，$0.05）——对 MCP 服务的工具进行提示词注入／工具投毒审计（OWASP LLM01/LLM08）。零外传：对于私有／受 OAuth 限制的服务，只需 POST tools/list JSON——不会有任何其他内容离开你的环境。没有免费的同类服务（而在令牌安全方面，已有免费的多链扫描器）。免费预览：POST /scan/mcp/preview。CI 门禁：uses: rezearcher/x402-data-api/actions/mcp-scan@main。
2. 交易前决策门禁（/gate/swap，$0.008 · /chain/token-report，$0.01）——提供与交易规模匹配的决策（GO/HOLD/BLOCK、SAFE/CAUTION/AVOID），而非需要 Agent 自行解读的原始标记。原生支持 Base；如果你在其他链上交易，请继续使用多链扫描器，并在 Base 上使用此服务。

以下是完整目录（加密货币／DeFi 数据、链上读取、大模型、数据增强）。实测可靠性见 /status（非 SLA）。

---

端点

加密货币与 DeFi 数据

端点	价格	返回内容
GET /crypto/prices?coins=bitcoin,ethereum,solana	$0.001	现货代币价格（DefiLlama），无需密钥。最多支持 25 个 CoinGecko id。
GET /crypto/funding?limit=20	$0.001	跨平台永续合约资金费率（Hyperliquid + OKX，故障时平稳回退），并提供资金费率价差和最佳做多／做空平台——呈现套利信号，而不只是单个平台列表。
GET /defi/yields?limit=20&project=&chain=&stable=	$0.001	DeFi 借贷／LP 的顶级收益率（DefiLlama），包含 APY 明细、7d/30d APY 趋势、IL 风险和 DefiLlama 的稳定性预测——适用于决策，而非原始列表。
GET /pm/markets?query=&limit=20	$0.005	Polymarket 实时预测市场：问题、结果、价格、交易量、流动性、结束日期。

Base 链上数据（JSON-RPC 读取原语）

原生支持 Base，采用多提供商 RPC 并自动故障转移（不会因单个提供商触发速率限制而导致付费调用失败）。

端点	价格	返回内容
GET /chain/block-number	$0.001	当前 Base 区块号
GET /chain/gas-price	$0.001	当前 Gas 价格（wei + gwei）
GET /chain/balance?address=	$0.001	原生 ETH 余额
GET /chain/token-balance?address=&token=	$0.001	ERC-20 代币余额
GET /chain/tx?hash=	$0.001	交易详情
GET /chain/receipt?hash=	$0.001	交易回执（状态、Gas 用量、日志）
GET /chain/code?address=	$0.001	合约代码检查——确认是否为合约，并检测 EIP-7702 委托 EOA（is_eip7702_delegate / delegate_address）
GET /chain/wallet?address=	$0.003	**组合信息：**一次调用获取 ETH 余额、交易次数和合约标记，并支持 EIP-7702 委托 EOA（is_eip7702_delegate / delegate_address）

Agent 交易关卡（新增）

Endpoint	Price	Returns
GET /gate/swap?token=0x…&side=buy|sell&notional_usd=N	$0.008	交易前的继续／暂缓／阻止决策，适用于任何 Base ERC-20：安全判定、风险评分、池子流动性、按你的交易规模计算的价格影响，以及标记。Agent 执行交换前调用一次。免费实时示例：/gate/swap/preview
GET /chain/token-report?token=0x…	参见 /openapi.json	一次调用即可获取完整的代币尽职调查报告（安全性 + 流动性 + 元数据）

安全性

Endpoint	Price	Returns
GET /scan/mcp?url=	$0.05	对目标 MCP 服务进行安全审计：工具投毒／提示词注入／数据外泄／危险能力／隐藏 Unicode（OWASP LLM01/LLM08）+ 风险评分
POST /scan/mcp {"tools":[…]}	$0.05	零出站审计——粘贴你自己的 tools/list 数组；返回相同的逐项发现，不会有任何内容离开你这边，我们也绝不会获取／调用你的服务。适用于不会公开 URL 的 OAuth 限制或私有 MCP 服务
GET /enrich/tech-risk?domain=	$0.05	技术栈指纹 → CVE（NVD）+ EPSS + CISA-KEV 攻击面风险
GET /enrich/domain?domain=	$0.01	公司信息 + 技术栈补充信息，包括通过 crt.sh 证书透明度日志、RDAP、DoH、HTTP 指纹进行的完整子域名枚举（subdomains[]）

免费预览：GET /crypto/prices/preview、/crypto/funding/preview、/defi/yields/preview、/chain/block-number/preview、/chain/gas-price/preview（完整实时数据，不会截断）、/scan/mcp/preview?url=。零出站 MCP 扫描（适用于私有／OAuth 限制服务）：POST /scan/mcp/preview 搭配 {"tools":[…]} 可免费预览计数；POST /scan/mcp 搭配相同请求体可进行付费逐项扫描——不会有任何内容离开你这边。单行命令：examples/mcp-scan-preview.sh。

---

MCP 服务（拉取通道）

添加一个远程 MCP 服务，Agent 即可使用整套工具。initialize 和 tools/list 免费，供 Agent 发现工具；付费的 tools/call 会返回 x402 挑战。

tools/list 会公布 22 个工具：crypto_prices、crypto_funding、defi_yields、pm_markets、 chain_block_number、chain_gas_price、chain_balance、chain_token_balance、chain_tx、 chain_wallet、chain_token_security（付费 Base RPC + 数据，支持 EIP-7702 委托 EOA）、 crypto_prices_preview、crypto_funding_preview、defi_yields_preview、pm_markets_preview、 chain_block_number_preview、chain_gas_price_preview、chain_token_security_preview（免费）， 以及 scan_mcp_server、scan_mcp_preview、enrich_tech_risk、enrich_domain（安全性）。

// add to your MCP client config
{
  "mcpServers": {
    "grey-ridge-x402": {
      "type": "streamable-http",
      "url": "https://x402-data-api.sigrunner.workers.dev/mcp"
    }
  }
}

MCP 客户端（mcp-client/ — stdio 配套程序）

对于仅支持 stdio 的 MCP 客户端（Claude Desktop、Cursor、命令行 Agent），本仓库附带一个 配套包 x402-data-api-mcp，位于 mcp-client/。它运行在 Agent 自己的机器上，通过 stdio 使用 MCP，并代理到同一个 Worker /mcp 端点——它不会增加数据范围，只提供传输 + x402 付款适配层，让 仅支持 stdio 的客户端也能使用相同的工具（共 22 个工具；配置钱包密钥后也可使用付费工具）。

安装／运行（本地路径）。 此包尚未发布到 npm，因此请从本仓库运行：

cd mcp-client
npm install
npm run build          # tsc → dist/server.js
node dist/server.js    # start (or: npm start)

预期使用方式（发布后）： npx x402-data-api-mcp（此包的 bin 目标为 dist/server.js，因此 npx 会运行同一个服务）。

配置。 将 mcp-client/.env.example 复制到 mcp-client/ 中的 .env：WORKER_BASE_URL 默认为已部署的 Worker（仅当要指向 自己的镜像时才需设置），而 X402_WALLET_PRIVATE_KEY 为可选项——设置后， 即可通过 x402 自动结算付费工具（HTTP 402）；留空则只运行 免费／预览工具。客户端启动时会直接从 process.env 读取这两个变量。

// stdio client config (local path)
{
  "mcpServers": {
    "grey-ridge-x402-local": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-client/dist/server.js"]
    }
  }
}

调用它（HTTP）

BASE=https://x402-data-api.sigrunner.workers.dev

# free preview — real sample, no payment
curl -s "$BASE/crypto/funding/preview"

# paid — returns HTTP 402 with an x402 payment-required challenge until you attach payment
curl -i "$BASE/crypto/funding?limit=10"

任何支持 x402 的客户端（例如 x402 库）都会自动处理 402 → 签名 → 重试。

状态监测

通过探测 cron 测量每条安全路由的正常运行时间和延迟，并发布在 docs/STATUS.md 中（每小时重新生成；统计窗口见文件中的说明，不构成 SLA）。

运行方式

单个 Cloudflare Worker 实现所有 HTTP 端点，以及受方法感知型 x402 网关保护的 MCP 服务。所有上游服务都是免费/无需密钥的公共 API（DefiLlama、Hyperliquid、OKX、Polymarket Gamma、Base JSON-RPC、NVD/EPSS/CISA-KEV、crt.sh/RDAP/DoH）；所有地址/哈希/域名输入都会经过验证和 SSRF 防护（上游主机固定，除明确限定范围的 /scan/mcp 和 enrichment 端点外，不接受用户提供的目标）。

许可证

MIT — 详见 LICENSE。

Agent 框架示例

交易前代币防护（/gate/swap，通过 x402 在 Base 上支付 $0.008 USDC）。免费示例：curl "https://x402-data-api.sigrunner.workers.dev/gate/swap/preview?token=degen"

• Node：docs/examples/swap-gate/gate.mjs
• LangChain.js 工具：docs/examples/langchain/swapGuardTool.mjs
• ElizaOS 操作：docs/examples/elizaos/swapGuardAction.mjs

市场数据购买者（适用于购买价格数据且不得将过时数据当作实时数据呈现的 Agent——Decision402 模式）：examples/market-data-decision-buyer.mjs。运行完整的 Agent 工作流——读取实时 402 报价、执行每次调用的 USDC 预算限制，通过免费预览验证数据源，支付 /crypto/prices（在 Base 上支付 $0.001），然后拒绝任何早于 MAX_AGE_SECONDS 的数据行。步骤 1-3 无需安装 npm 包即可运行：node examples/market-data-decision-buyer.mjs bitcoin,ethereum。

Python / LangChain / CrewAI

pip install "git+https://github.com/rezearcher/greyridge-x402-tools" — 提供 token_report() 和 swap_gate() 辅助函数（默认使用免费预览，可选付费 x402 模式）以及 LangChain 工具。指南：https://rezearcher.github.io/greyridge-x402-tools/

免费试用你自己的代币

curl "https://x402-data-api.sigrunner.workers.dev/chain/token-report/preview?token=0xYourBaseToken" 返回与付费路由（$0.01）相同的完整深度报告。/gate/swap/preview?token=0x… 每天为每个 IP 提供 3 次针对真实代币的免费 GO/HOLD/BLOCK 检查。

Agent 技能（适用于 OpenClaw/Hermes 风格 Agent 的即插即用 SKILL.md）：https://github.com/rezearcher/greyridge-token-safety-skill

MCP 服务的 CI 网关

在 CI 中使用 uses: rezearcher/x402-data-api/actions/mcp-scan@main 并设置 url: 或 tools-file:，即可运行免费的 MCP 工具投毒预览，并在判定结果为 block 时失败。参见 actions/mcp-scan/README.md。

Python 提示：Cloudflare 边缘会以 403 拒绝默认的 Python-urllib User-Agent。请使用 requests/httpx，或设置任意自定义 User-Agent 标头。