DeFade

DeFade SDK

官方 JavaScript/TypeScript 客户端，用于调用 DeFade API，为 Solana、Ethereum、Base、BSC、Robinhood Chain、Arc 和 Hyperliquid 上的代币提供 rug pull 风险评分和链上行为取证：发行区块捆绑检测、多跳资金来源追踪、部署者历史、内部人士网络、狙击机器人、聪明钱流向、流动性验证。

DeFade 回答的问题与合约扫描工具不同。它不问“这个代币的代码有没有问题？”，而是问“这个项目背后的钱包在发行时的行为是否像 rug pull 操作者？”——已确认的 Solana rug pull 中，99.9% 撤销了铸币权限，72.9% 锁定了 LP，因此仅凭代币状态已无法区分安全项目和伪装项目。

• 零依赖。 Node 18+（使用全局 fetch）。支持 CJS 和 ESM。
• 有意保持轻量。 响应是未经修改的 API JSON。client.get() 可访问 SDK 尚未封装的任何端点。
• 同时也是 MCP 服务——Claude 和 ChatGPT 可以通过同一个 API 执行真实扫描。见下文。

安装

npm install defade

前往 defade.org/developers 获取 API 密钥（密钥以 df_ 开头）。

快速开始

import DeFade from 'defade';

const client = new DeFade({ apiKey: process.env.DEFADE_API_KEY });

// Full multi-module scan — returns a SAFETY score (100 = clean)
const scan = await client.analyze('6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN');

// Rug pull probability (100 = dangerous) with the evidence behind it
const risk = await client.rugScore('6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN');

// Any endpoint takes ?chain= — omitted means solana
const eth = await client.holders('0x6982508145454ce325ddbe47a25d4ec3d2311933', { chain: 'ethereum' });

警告

两个评分的方向相反。 analyze() 返回的是安全评分——100 表示安全。rugScore() 返回的是 rug pull 概率——100 表示危险。把 90 的安全评分理解为“有 90% 的 rug pull 概率”，就会得出完全相反的结论。每个方法的 JSDoc 都会重申这一点。

端点

所有代币方法都接受 (address, { chain? })，并返回 API 解析后的 JSON。tokenPrice 还接受 type 参数，即蜡烛图周期，用于设置查询窗口的回溯时长：'15m'（默认值）≈ 2.5 天，'1H' ≈ 10 天，'4H' ≈ 40 天，'1D' ≈ 最多一年的日线数据。

分组	方法
扫描与评分	analyze、rugScore
代币状态	tokenPrice、holders、liquidity、socials
发行取证	bundles、bundlesPro、historicalBundles、snipers、devTracker、feeFingerprint
钱包网络	insiderNetwork、fundingOrigin、fundingGraph、sybilCluster
资金流向	whales、smartMoney、copyTraders、kol
跨代币	holderOverlap(mints[])、trending
账户	usage
备用入口	get(path, params) — 任意 /v1 路径

API 会在 GET https://api.defade.org/v1 上自我描述——其中包含端点列表、套餐、单位成本、速率限制和支持的链，并始终保持最新。也可以在代码中调用：await DeFade.discover()。

链

solana（默认值）、ethereum、base、bsc、robinhood、arc、hyperevm（Hyperliquid）。在任何代币方法上都可以传入 { chain: 'base' }。所有套餐均涵盖所有链；部分会遍历资金图的 EVM 模块比标准请求消耗更多单位——发现文档列出了相关模块，defade.org/developers提供当前定价。

错误

每次失败都会抛出 DeFadeError，包含 .status（HTTP 状态码；网络错误或超时时为 0）和 .body（如果存在，则为 API 错误 JSON）。受速率限制的调用会抛出状态码为 429 的错误；client.usage() 会显示剩余单位数和限制。对新代币进行完整扫描可能需要数十秒——默认超时时间为 120s，可通过 timeoutMs 配置。

import DeFade, { DeFadeError } from 'defade';

try {
  await client.analyze(mint);
} catch (e) {
  if (e instanceof DeFadeError && e.status === 429) {
    // back off; e.body has details
  }
}

MCP 连接器：从 Claude 和 ChatGPT 执行扫描

同一 API 也以远程 MCP 服务的形式提供，因此 AI 助手可以在对话中执行真实扫描，而不是回忆过时的训练数据：

• URL： https://api.defade.org/mcp（传输方式：streamable-http）
• 身份验证： x-api-key 请求头；对于无法设置请求头的客户端，也可使用 ?api_key=YOUR_KEY
• 注册信息： 已以 org.defade/defade 的名称发布在官方 MCP Registry 中

将其添加到 Claude Code：

claude mcp add --transport http defade "https://api.defade.org/mcp?api_key=YOUR_KEY"

在 Claude 或 ChatGPT 中，使用上述 URL 添加自定义连接器。工具调用的用量会像 REST 调用一样计入你的密钥。每个工具都需要一个 address 和一个可选的 chain；get_token_price 还接受可选的 timeframe（1m … 1D），因此 1D 可通过最多一年的每日蜡烛图数据，回答有关峰值、回撤和价格历史的问题。完整说明：defade.org/api-docs#mcp。

stdio 传输方式（Claude Desktop、本地客户端）

此软件包还提供 defade-mcp，这是一个本地 stdio MCP 服务，可代理请求至托管端点，适用于只能启动本地命令的客户端：

{
  "mcpServers": {
    "defade": {
      "command": "npx",
      "args": ["-y", "defade-mcp"],
      "env": { "DEFADE_API_KEY": "df_your_key" }
    }
  }
}

defade-mcp 作为独立的别名软件包发布，因此上述代码片段可以 直接使用；npx -p defade defade-mcp 会运行此软件包中的同一二进制文件。 两者会以匹配的版本号一起发布。

无需密钥也能完成握手并列出工具；之后扫描工具会回复如何获取密钥的说明。DEFADE_MCP_URL 可用于覆盖上游端点以进行测试。

链接

• API 文档 · 获取密钥 · 实时 API 自述信息
• Solana Rug 现状，2026 年 — 18,884 个被标记代币揭示了什么
• 为什么安全评分完美的代币仍会 Rug
• defade.org — 网页扫描器（免费套餐，无需密钥）

许可证

MIT © DeFade Ltd. 此 SDK 为开源软件；它所连接的 DeFade API 是一项托管式商业服务，并提供免费套餐。