DeFade

DeFade SDK

DeFade API の公式 JavaScript/TypeScript クライアントです。Solana、Ethereum、Base、BSC、Robinhood Chain、Arc、Hyperliquid 上のトークンについて、ラグプルのリスクスコアとオンチェーンの行動フォレンジックを提供します。ローンチブロックのバンドル検出、複数ホップの資金源追跡、デプロイヤーの履歴、インサイダーネットワーク、スナイパーボット、スマートマネーの流れ、流動性の検証に対応しています。

DeFade が答えるのは、コントラクトスキャナーとは異なる問いです。「このトークンのコードに問題がありそうか？」ではなく、「ローンチに関わったウォレットは、ラグプルを仕掛ける者のような行動をしたか？」です。確認済みの Solana ラグの 99.9% でミント権限が取り消され、72.9% で LP がロックされていました。そのため、トークンの状態だけでは、安全なものと安全を装ったものを見分けられなくなっています。

• 依存関係ゼロです。 Node 18 以降（グローバルな fetch を使用）。CJS と ESM に対応しています。
• 意図的に薄く設計されています。 レスポンスは API の JSON をそのまま返し、変更しません。client.get() を使えば、SDK にまだラッパーがないエンドポイントにもアクセスできます。
• MCP サーバーとしても使えます — Claude と ChatGPT が同じ API で実際のスキャンを実行できます。以下をご覧ください。

インストール

npm install defade

API キーは defade.org/developers で取得できます（キーは 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' });

警告

2 つのスコアは逆方向を示します。 analyze() が返すのは安全性スコアで、100 は問題なしを意味します。rugScore() が返すのはラグプルの確率で、100 は危険を意味します。安全性スコア 90 を「ラグプルの確率 90%」と解釈すると、まったく逆の答えになります。各メソッドの JSDoc にもこの点が記載されています。

エンドポイント

すべてのトークンメソッドは (address, { chain? }) を受け取り、API が解析した JSON を返します。tokenPrice は type も受け取ります。これはローソク足のサイズで、対象期間の長さを決めます。'15m'（デフォルト）は約 2.5 日、'1H' は約 10 日、'4H' は約 40 日、'1D' は最大で約 1 年分の日足データです。

グループ	メソッド
スキャンとスコア	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
• レジストリ： 公式 MCP Registry に org.defade/defade として公開されています

Claude Code に追加します。

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

Claude または ChatGPT では、上記の URL を使ってカスタムコネクターを追加します。ツール呼び出しは REST 呼び出しと同様に、API キーに対して課金されます。各ツールは address と省略可能な chain を受け取ります。get_token_price は省略可能な timeframe（1m … 1D）も受け取るため、1D を指定すると、最長 1 年分の日次ローソク足を使って、高値、ドローダウン、価格履歴に関する質問に回答できます。詳しい手順はこちら：defade.org/api-docs#mcp。

stdio トランスポート（Claude Desktop、ローカルクライアント）

このパッケージには、ホスト型エンドポイントにプロキシするローカル stdio MCP サーバー defade-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 のライブ自己説明
• The State of Solana Rugs, 2026 — フラグが付けられた 18,884 個のトークンから分かること
• 完璧な安全性スコアのトークンでもラグを起こす理由
• defade.org — ウェブスキャナー（無料枠あり、キー不要）

ライセンス

MIT © DeFade Ltd. この SDK はオープンソースです。この SDK が接続する DeFade API は、無料枠のあるホスト型商用サービスです。