solenrich について
solenrichは、AIエージェント向けにSolanaのオンチェーン分析を提供し、生データだけでなく根拠付きの構造化された判定を返します。ウォレット、トークン、ミームコイン、スマートマネー、無期限先物を扱う決定論的なエンドポイントを備え、APIキーやアカウントなしでx402による呼び出しごとのUSDC決済を行います。
主な機能
- 01ウォレットとトークンのリスク分析
- 02トランザクション解析とウォレット関連確認
- 03ミームコインのエントリー・退出シグナル
- 04スマートマネーと取引の分析
- 05複数取引所のパーペチュアル分析
- 06根拠付きの構造化判定
活用シーン
- 01取引前にウォレットやトークンを評価
- 02ミームコインのエントリーや退出条件を確認
- 03パーペチュアルの資金調達率や取引所を比較
- 04ウォレットの関連性や取引活動を調査
MCP 対応
すべてのAPIエンドポイントがMCPサーバーのツールとしても公開され、MCPクライアントから同じオンチェーン分析を利用できます。呼び出しには、APIに記載されたx402決済を使用します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.solenrich.com/mcpclaude mcp add --transport http 0xsardius-solenrich https://api.solenrich.com/mcp{"mcpServers":{"0xsardius-solenrich":{"type":"http","url":"https://api.solenrich.com/mcp"}}}Cursor で開く{"servers":{"0xsardius-solenrich":{"type":"http","url":"https://api.solenrich.com/mcp"}}}VS Code で開く{"mcpServers":{"0xsardius-solenrich":{"type":"http","url":"https://api.solenrich.com/mcp"}}}{"mcpServers":{"0xsardius-solenrich":{"serverUrl":"https://api.solenrich.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
49| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| depth | enum | いいえ | light = 基本プロフィール、full = DeFi ポジションと関連ウォレットを含むlight | full |
| address | string | はい | Solana ウォレットアドレス(base58、32~44 文字) |
詳細
SolEnrich
Solana エージェント向けのオンチェーンインテリジェンスです。エージェントは x402 経由で呼び出しごとに少額の USDC を支払い(Solana または Base 上で、API キーもアカウントも不要)、1 回のリクエストで、根拠を添えた判定結果を受け取ります。形式は構造化 JSON、または LLM 向けの短い自然言語ブリーフィングです。
生データではなく判定結果を提供します。トークンには SAFE / CAUTION / RISKY、ポジションには EXIT / DERISK / HOLD、StonkFun の報酬コインには PAYING / STALE / NEVER、コインの作成者には ESTABLISHED / SERIAL_LAUNCHER、市場には RISK_ON / NEUTRAL / RISK_OFF を返します。スコアリングは決定論的で(パイプラインに LLM は含まれません)、同じ入力には常に同じ回答が返されます。スイートは、ウォレットとトークン、ミームコインの最前線(エントリーとエグジット)、スマートマネー、5 つの取引所にまたがるパーペチュアル、StonkFun の報酬コインを対象としています。すべてのエンドポイントは MCP サーバー上のツールでもあります。
ライブ API: https://api.solenrich.com/ ランディングページ: https://solenrich.com ドキュメント(エージェントが読み取り可能): https://api.solenrich.com/docs
クイックスタート
# Health check
curl https://api.solenrich.com/health
# Agent card (A2A discovery)
curl https://api.solenrich.com/.well-known/agent.json
# List all 51 endpoints (50 paid + 1 free)
curl https://api.solenrich.com/entrypoints
# Full API documentation (agent-readable JSON)
curl https://api.solenrich.com/docs
# Free demo (no payment required, 10 queries/hr)
curl -X POST https://api.solenrich.com/demo/enrich \
-H "Content-Type: application/json" \
-d '{"address":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}'
支払いの仕組み
- エージェントが支払いなしでエンドポイントを呼び出します。
- SolEnrich は
402 Payment Requiredとpayment-requiredヘッダーを返します。ヘッダーには価格、Solana と Base 上の USDC 送金先アドレス、レスポンスの実例が含まれます。 - エージェントはその価格分の USDC 送金に署名し、支払いを添えてリクエストを再送します(どの x402 クライアントでも実行できます。
skills/solenrich/examples/x402/を参照してください)。 - Coinbase CDP ファシリテーターがオンチェーンで支払いを決済し、SolEnrich が回答を返します。
約 20 秒を超えて実行される可能性があるエンドポイントでは、処理を開始する前に支払いを決済するため、実行に時間がかかっても支払いが失われることはありません。支払いは x402scan で確認できます。
エンドポイント
すべての有料エンドポイントは、input オブジェクトを含む JSON ボディを指定して /entrypoints/{key}/invoke に POST リクエストを送信します。有効な x402 支払いヘッダーがない場合、エンドポイントは支払い方法を示す HTTP 402 を返します。
コア(5 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
enrich-wallet-light | $0.002 | address, format | SOL 残高、トークン保有状況、NFT の内訳、ラベル、リスクスコア |
enrich-wallet-full | $0.005 | address, format | + DeFi ポジション、接続済みウォレット、拡張トランザクション履歴 |
enrich-token-light | $0.002 | mint, format | 価格(3 つの情報源の中央値)、時価総額、取引量、流動性、リスクフラグ |
enrich-token-full | $0.004 | mint, format | + 上位 20 保有者、HHI 集中度、ボラティリティ指標 |
parse-transaction | $0.001 | signature, format | 種類の検出、プロトコルの特定、送金の内訳 |
プレミアム(5 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
whale-watch | $0.008 | mint, format | 蓄積・分配の追跡機能付き上位保有者情報 |
batch-enrich | $0.015 | addresses[], type, depth, format | 最大 25 件のウォレットまたはトークンを並列でエンリッチ |
wallet-graph | $0.010 | address, depth, format | トランザクション接続のマッピングとクラスター検出 |
wallet-link-check | $0.030 | wallet_a, wallet_b, context, format | 2 つのウォレットは同じ所有者のものか?直接送金、最初の資金提供者、新規ウォレットの経過期間、x402 履歴(支払い先ウォレットのローテーションか、乗っ取りか)に基づく判定結果と信頼度 |
copy-trade-signals | $0.010 | address, format | 損益、勝率、シャープレシオ/ソルティノレシオ、最大ドローダウン |
due-diligence | $0.020 | mint, format | SAFE / CAUTION / RISKY の判定結果を含む複合リスクレポート |
比較(2 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
compare-tokens | $0.006 | mints[] (2-3), format | 価格、流動性、ボラティリティ、HHI、リスクを並べて比較。ランキングと要約 |
compare-wallets | $0.006 | addresses[] (2-3), depth, format | ポートフォリオ、アクティビティ、リスク、ラベルを並べて比較。ランキングと要約 |
時系列(3 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
token-trend | $0.006 | mint, lookback, format | 時系列のトークン指標 — 日次スナップショットに基づき、指標ごとに改善・低下・安定の方向を表示 |
wallet-history | $0.006 | address, lookback, format | 日次スナップショットに基づくポートフォリオ価値、SOL 残高、リスクスコアの変動、およびポジションの変更 |
portfolio-history | $0.006 | address, period, format | ピーク、ボトム、最大ドローダウン、開始時点との変動を含む、ポートフォリオ全体の時系列(7/14/30d) |
ディスカバリーとプロトコル(2 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
new-tokens | $0.012 | min_liquidity_usd, max_risk_score, limit, format | 最近ローンチされたトークンを、情報を付加してリスクスコアを算出し、安全性の高い順に表示 |
protocol-profile | $0.008 | protocol, include_yields, format | プロトコルの TVL、利回り、オンチェーンアクティビティ、健全性シグナル、自動化されたアクティビティの割合 |
パーペチュアル先物インテリジェンス(8 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
perps-market-structure | $0.012 | format | Jupiter Perps における SOL/BTC/ETH の OI、利用率、借入 APR、スキュー、健全性フラグ |
perps-trader-profile | $0.010 | address, format | 複数の取引所(Jupiter + Adrena)におけるオープンポジション、レバレッジ、PnL、トレーダー分類 |
perps-cross-venue-funding | $0.015 | market, include_reference, format | Jupiter、Adrena、Hyperliquid、dYdX における資金調達率/借入 APR と OI — サイドごとの最適なエントリー、裁定取引スプレッド |
perps-venue-comparison | $0.020 | market, side, size_usd, format | 指定サイズで取引する最適な取引所:スリッページ、手数料、OI の余力、合計エントリーコスト、推奨 |
perps-basis-signal | $0.015 | asset, min_yield_apr_pct, format | 借入コスト控除後の純利回りに基づくベーシストレードのスキャナー — 取引所ごとに実際に得られる利回り |
perps-market-trend | $0.008 | lookback, format | 市場ごとの価格、OI、スキュー、利用率、借入 APR の変動(7/14/30d)— 市場レジームの検出 |
hyperliquid-trader-profile | $0.012 | address (0x), format | Hyperliquid のリアルタイムポジション、レバレッジ、清算までの距離、リスクフラグ、週次/月次/全期間の PnL |
hyperliquid-smart-money | $0.05 | market, top_traders, format | リーダーボードによる絞り込み → 一貫性を基準に選別したトレーダー → コインごとのポジション保有状況のコンセンサス + トップトレーダーの詳細分析 |
オーケストレーション(2 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
trending-signals | $0.050 | min_liquidity_usd, max_risk_score, limit, format | トレンドトークンの複合ランキング:ディスカバリー + クジラ監視 + リスクスコアリング(根拠付き) |
smart-money-flow | $0.100 | wallets[], min_win_rate, lookback_days, format | 初期ウォレットをスコアリングして勝者を絞り込み、蓄積中のトークンとクラスターを表示 |
Trenches — ミームコインインテリジェンス(5 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
smart-money-trenches | $0.05 | hours_back, max_token_age_hours, min_buyers, limit, format | 現在、実績のある勝ち組ウォレットのうち、どれが新規ローンチ(6 時間未満)に飛びついているかを確認します。実現損益で精査したシードセットを使用し、ボットを除外して、スマートマネーの個別購入者数と新しさに基づいてランク付けします。 |
runner-scan | $0.04 | max_token_age_hours, min_liquidity_usd, min_volume_h1_usd, limit, format | 現在、どの新しいトークンが 加速している かを確認します。購入率の加速(5 分対 1 時間、1 時間対 6 時間)、買い圧力、出来高/価格の勢い、保有者の増加、流動性の推移を分析します。RUNNING/IGNITING/PARABOLIC_LATE/FADING の段階を 0~1 のスコアで示します。すでに大きく上昇したトークンはエントリーリスクとして、LP の引き上げはラグプルとして警告します。 |
trenches-scan | $0.08 | max_token_age_hours, min_liquidity_usd, limit, format | 3 つの Trenches シグナルを 1 回の呼び出しで確認します。オンチェーンの勢い × 実績のある勝ち組の購入 × エージェントの注目度を組み合わせ、コンフルエンス数、トークンごとの根拠、HIGH_CONFLUENCE/MODERATE/SINGLE_SIGNAL の判定を付けてランク順に一覧表示します。 |
trenches-check | $0.03 | mint, format | このスイートを特定のトークンに絞り込みます。飛びつく前にチェックを実行してください。trenches-scan と同じ 3 つの観点を候補トークンに対して確認し、判定、根拠、各観点の詳細を返します。エントリー前に全体を確認するには due-diligence と組み合わせてください。 |
exit-signal | $0.04 | mint, entry_price_usd, format | 保有中のトークンの売り側判定を返します。0~1 のエグジットスコアとともに、EXIT/DERISK/HOLD を示します。売り圧力、購入率の鈍化、出来高の減少、上昇時の分配、上位保有者の動向(クジラによる売却か蓄積か)、流動性の推移、保有者の入れ替わりを分析します。ラグプルのトリガー(LP の引き上げ、進行中の投げ売り)はすべての判定に優先します。あらゆる経過時間のトークンに対応します。 |
コレクティブル/RWA(1 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
gacha-ev-scan | $0.02 | machine, franchise, exit_strategy, min_edge_pct, format | Jupiter Gacha(Collector Crypt)のパック期待値スキャン。保険適用後の総期待値を、保証された即時買い戻し価格(85~93%、≤72h)およびマーケットプレイスでの販売(手数料 −2%、約定リスク)と比較します。マシンごとに POSITIVE_EV/HOUSE_EDGE/NEGATIVE_EV の判定を返します。プラットフォームが総期待値の見出しの陰に隠している、実現可能な期待値を示します。 |
StonkFun — クオート通貨ペアおよび報酬コイン(5 エンドポイント、うち 1 つは無料)
stonkfun.xyz でローンチされたコインは、クオート資産(NVDAX/SPYX/TSLAX などの xStocks、Backpack のプレストック、通貨、カスタムミント)に対して価格が設定されます。報酬モードのコインには Token-2022 の送金税(100 または 300 bps)が設定され、クオートトークンで保有者に支払われます。これらのエンドポイントはチェーンから税設定を読み取り、保有者への還元状況をスコア化し、保有者利回りを算出し、報酬コイン全体をスクリーニングするとともに、自分で構築した LaunchLab ローンチをブロードキャスト前に事前チェックします。
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
stonk-pairs | 無料 | category, launchable_only, format | ローンチでペアにできるクォート資産、正規化されたカテゴリ、is_agent_launchable フラグ(ローンチ可能+LaunchLab 対応済み+許可カテゴリ)を返します。最初に呼び出してください。ローンチの quoteMint は、これらのいずれかである必要があります |
stonk-reward-risk | $0.005 | mint, format | 支払い状況(PAYING(過去24時間以内に保有者への支払いあり)、STALE、NEVER、NOT_REWARD)に加えて、trading_cost(税率 bps、往復%)と、チェーンから読み取った0~100の健全性スコアを返します。スコアは、手数料 bps と上限、出金権限(StonkFun の配布者である必要があります)、手数料の変更可能性、分配とその直近性、フライホイール、保有者数と集中度、クォートカテゴリ、経過日数に基づきます |
stonk-yield-batch | $0.05 | mints(最大25件)またはスクリーナーフィルター、limit(≤25)、format | インデックスからミリ秒単位で、1回の呼び出しで最大25コインの stonk-yield を返します。コインごとの7日間/30日間/生涯利回り、報酬資産、時価総額、保有者数、最終支払いが含まれます。stonk-screener とコインごとの stonk-yield 呼び出しより低コストです |
stonk-alerts | $0.02 | mints(1~25件)、since、min_holders_change_pct、stale_after_hours、format | 前回確認時から報酬コインに起きた変化を返します。支払いの発生、支払いの停滞、取引停止、保有者の変動、以降に支払われた報酬などです。コインごとの現在の支払い状況も含まれます。インデックスからミリ秒単位で取得できます。ポーリングし、checked_at を since として渡してください |
stonk-yield | $0.005 | mint, format | 過去7日間/30日間/生涯の保有者利回りを返します。平均時価総額に対するクォート資産での報酬を米ドル換算し、7日未満の場合は注意フラグ付きで年率換算します。クォート資産へのエクスポージャーも含まれます。保有者はコインとそのクォート資産の両方をロングしています |
stonk-screener | $0.01 | quote_mint, category, min_holders, min_age_days, max_age_days, min_volume_24h_usd, max_market_cap_usd, paying_only, live_only, sort, limit, format | 10分間隔の取り込みデータから、すべての報酬コインをメモリ上で返します。各行には、payout_status、最終支払いからの経過時間、live(取引あり、かつ過去24時間以内に支払いあり)、round_trip_pct(税コスト)、保有者数、利回り、取引高、時価総額が含まれます。volume24h(デフォルト)、lastPayout、holders、priceChange24h、yield7d、yield30d、rewardsUsd で並べ替えられます |
stonk-gems | $0.03 | quote_mint, category, max_age_days, min_holders, max_market_cap_usd, limit, format | ライブコインの候補リストです。直近の保有者への支払い、保有者数、時価総額の上昇余地、24時間の売買回転率、経過日数、モメンタム、クォートの強さ、フライホイールに基づき、報酬コインを0~100でランク付けします。コインごとに、理由と警告付きで GEM/WATCH/NOISE/DEAD のステージを示します。測定対象は稼働状況、支払い状況、流動性であり、価格予測ではありません(ペーパーテストでは、高スコアでも市場を上回りませんでした)。stonk-creator および stonk-quote と組み合わせてください |
stonk-launch-intel | $0.02 | category, min_coins, sort, limit, format | 何を、どの資産と組み合わせてローンチするかを示します。クォート資産ごとに、ローンチ数(24時間/7日間)、本日取引中の割合、本日支払い中の割合、3日目以降の生存率、保有者数と時価総額の中央値、取引率/支払い率を含む100 bps 対300 bpsの税率構成、過密度、0~100の需要スコアを返します。全体統計とわかりやすい推奨事項も含まれます |
stonk-quote | $0.005 | mint, size_usd, hold_days, format | スワップなしで、指定サイズの1回の取引にかかるコストと損益回収を計算します。エントリー/決済コスト(税+価格インパクト)、往復%と損益分岐点となる値動き、比例配分による支払い分(ダスト警告付き)、実際の利回り履歴に基づく保有期間中の予想支払い、PAYS/MARGINAL/COSTS/NOT_PAYING と損益分岐に必要な保有日数を返します |
stonk-market-pulse | $0.005 | format | StonkFun 市場が上昇傾向か下落傾向かを示します。値上がりしたライブコインの割合(ブレッドス)と値動きの中央値に基づく RISK_ON/NEUTRAL/RISK_OFF に加え、出来高加重の値動き、1日あたりのローンチ数、取引中および支払い中の割合、保有者収益の直近7日間とその前の7日間との比較、最も強いクォート区分と最も弱いクォート区分、日ごとのブレッドスの推移を返します |
stonk-creator | $0.01 | creator または mint、format | StonkFun クリエイターの実績を追跡します。ESTABLISHED/MIXED/SERIAL_LAUNCHER/NEW、1日あたりおよび1週間あたりのローンチ数、ローンチから3日を超えても取引が続いているコインの割合(単発クリエイターの基準値は19%、連続ローンチするクリエイターは5%)、過去24時間の支払い、生存中のコインを返します |
stonk-launch-preflight | $0.25 | unsigned_transaction, quote_mint, mode, launch_params, format | LaunchLab の初期化命令をデコードし、すべてのパラメーターを StonkFun の /launchlab/pricing と照合します。GlobalConfig、モードごとのプラットフォーム ID、カーブ、供給量、totalSellA、調達額、6桁小数の Token-2022 ベースミント、クォートトークンプログラム、最後のカーブルールアカウント、報酬モードの転送手数料が対象です(Raydium の transferFeeBasePoints/maxinumFee というスペルも検出します)。ok、mismatches[{field, expected, actual, fix}]、warnings を返します。不一致のプールは決して採用されません。税は誰にも渡りません |
インテリジェンスフィードとシグナル(4 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
feed-latest | $0.005 | since, format | 毎日のインテリジェンス概要 — 事前計算されたトレンドランキングを24時間キャッシュし、定期的なポーリング向けに構築 |
consensus-signal | $0.005 | address/type or limit, window, format | 他のエージェントが現在問い合わせている内容 — リクエストストリームから得られる独自の注目度シグナル |
attention-momentum | $0.02 | window, limit, format | エージェントの注目度の加速度でトークンをランキングし、価格との乖離も表示します:early_signal(注目度上昇、価格横ばい)/distribution_risk(注目度低下、価格急騰) |
check-alerts | $0.008 | tokens[], wallets[], since, criteria, format | ポーリングベースのアラート:価格急騰、クジラの資金フロー、リスクの変化、さらにパープス関連イベント(ポジションの追加/決済、清算接近、損益の変動) |
自然言語(1 エンドポイント)
| エンドポイント | 価格 | 入力 | 説明 |
|---|---|---|---|
query | $0.003 | question, format | 適切なエンリッチャーに振り分けられる、平易な英語での質問 |
リクエスト例
curl -X POST https://api.solenrich.com/entrypoints/compare-tokens/invoke \
-H "Content-Type: application/json" \
-d '{"mints":["JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"format":"both"}'
リクエストボディはフラットな JSON で、各エンドポイントのスキーマは/openapi.jsonに記載されています。{"input": {...}}というエンベロープも受け付けます。
出力形式
すべてのエンドポイントでformatパラメーターを使用できます。
json— エージェント間での利用に適した構造化データllm— LLM のコンテキストウィンドウ向けの自然言語による概要(Markdown)both—llm_summaryフィールドを追加した JSON データ
スコアリング方法
すべてのスコアリングは決定論的なオンチェーンロジックで行われます — パイプライン内で LLM 推論は一切使用しません。
ウォレットリスクスコア(0.0 - 1.0)
オンチェーンアクティビティに基づく7つの加算要素:
| 要素 | 重み |
|---|---|
| 高い取引集中度(少数の取引相手) | +0.15 |
| 取引の多様性が低い | +0.10 |
| 新しいウォレット(作成から30日未満) | +0.15 |
| ボットのようなパターン(高頻度、反復的) | +0.20 |
| 既知のリスクのあるプログラムとのやり取り | +0.15 |
| エアドロップファーミングの兆候(多数の少額トークンアカウント) | +0.10 |
| プロトコルの多様性が低い(2プロトコル未満) | +0.10 |
リスクレベル: LOW(< 0.25) | MODERATE(0.25-0.50) | ELEVATED(0.50-0.65) | HIGH(0.65-0.80) | CRITICAL(> 0.80)
HHI(ハーフィンダール・ハーシュマン指数)
オンチェーン上位20ホルダーに基づく保有者集中度の指標:
- < 1500 — 十分に分散
- 1500-2500 — 中程度に集中
- > 2500 — 高度に集中
価格変動率
DexScreener の複数時間枠データから算出(追加の API 呼び出しはゼロ):
- LOW — 日次標準偏差 < 3%
- MODERATE — 3-8%
- HIGH — 8-15%
- EXTREME — > 15%
トークンの価格設定
最大3つのソース(Helius DAS、DexScreener、Jupiter)の中央値。中央値を使うことで、単一の DEX に由来する外れ値の影響を抑えます。
アーキテクチャ
Client → x402 Paywall → Entrypoint Router → Enrichment Engine → Format Router → Response
リポジトリの構成
| パス | 内容 |
|---|---|
src/enrichers/ | スコアリングロジック:各エンリッチャーがデータを取得し、相互照合してスコアを算出します。判定ルールはユニットテスト付きの純粋関数です(例:stonk-creator.ts、stonk-pulse.ts、wallet-link.ts、risk-scorer.ts)。 |
src/entrypoints/ | エンドポイントスイートごとに1ファイル:入力スキーマ、ハンドラー、概要。 |
src/sources/ | Helius、Solana RPC、DexScreener、Jupiter、Birdeye、DeFi Llama、StonkFun、パープス取引所向けのクライアント。 |
src/lib/agent.ts | アプリのセットアップ、x402 決済ミドルウェア、メトリクス、/docs。 |
src/mcp-tools.ts | MCP サーバーのツール(エンドポイントごとに1つ)。 |
src/openapi.ts、src/lib/llms-txt.ts | 検出用インターフェース:OpenAPI、llms.txt。 |
agents/solscout/ | テストエージェント:本番環境で各エンドポイントに支払い、応答を検証します。 |
skills/solenrich/ | インストール可能なエージェントスキル。 |
test/ | ユニットテスト(CI で実行)とエンドポイントのライブチェック。 |
データソース
| ソース | 用途 |
|---|---|
| Helius | DAS API(アセット、トークンアカウント)、強化されたトランザクション解析、RPC |
| DexScreener | トークン価格、市場データ、流動性、OHLCV |
| DeFi Llama | プロトコルのTVL、利回りデータ |
| Jupiter | トークン価格(相互参照)、メタデータ、検証ステータス、パーペチュアルの見積もり |
| Birdeye | 実際の保有者数、ボラティリティ計算用の日次OHLCV |
| Solana RPC | SOL残高、ミント情報、上位20名の保有者、Token-2022の送金手数料、Jupiter Perps、Adrena、Flashのオンチェーンアカウント |
| StonkFun public API | 報酬コイン、支払い、ローンチ台帳(作成者)、収益履歴 |
| Hyperliquid + dYdX v4 | クロスチェーンのパーペチュアル取引の参照データ(資金調達率、ベーシス) |
エンティティのラベル付け
20以上の既知のSolanaアドレスを、すべてのエンリッチメント結果で自動タグ付けします。CEXウォレット(Binance、Coinbase)、プロトコルアドレス(Raydium、Orca、Jupiter)、ブリッジ、財団が含まれます。
NFTの分類
Solanaウォレット上の非代替性アセットの大半は、依頼なく送られた圧縮ドロップです。そのため、NFTの単純な件数では収集活動を過大評価してしまいます。あるウォレットを調査したところ、非代替性アセットは118件ありましたが、実際に保有していたのは15件で、残りの103件はエアドロップでした。そのうち複数はドレイナーの罠でした。
ウォレットのエンリッチメントでは、nft_summaryとして、合計がnft_countになる3つの分類を返します。
| 分類 | 意味 |
|---|---|
collected | 非圧縮で、スパムとしてフラグ付けされていないアセットです。これらのミントにはアセットごとにレンタル料がかかるため、通常は購入するか、意図的にミントされています。 |
airdropped | 圧縮されており、スパムとしてフラグ付けされていないアセットです。まとめて安価にミントできるため、通常は依頼なく送られています。 |
suspected_spam | 名前または説明に、請求を促す誘導文、埋め込みドメイン、あるいはフィルター回避用の不可視文字が含まれています。 |
nft_collectionsには、規模の大きいコレクションが、実際の保有分を先頭に並べて表示されます。distinct_collectionsは、名前の付いたコレクションに属する収集済みアセットのみを数えます。
スパム検出は名前と説明のパターンマッチングで、圧縮アセットのみを対象とします。これは判定ではなくシグナルとして扱ってください。宣伝文句を含む正当な圧縮ドロップがフラグ付けされる場合もあります。nft_collectorラベルの付与には、collectedに分類されるNFTが10件以上必要なため、エアドロップの件数だけでは付与されなくなりました。
エージェントスキル
1行で、Claude Code、Cursor、Codexなど、Agent Skillsを読み込むエージェントにSolEnrichスキルをインストールできます。このスキルでは、質問ごとにどのエンドポイントを使うか、x402を使って呼び出しごとに料金を支払う方法、トレードとStonkFunのワークフローをエージェントに教えます。
npx skills add 0xSardius/solenrich --skill solenrich
ソース:skills/solenrich/。skills.shに掲載されています。データの呼び出しは有料です(x402、SolanaまたはBase上のUSDC)。エージェントにはUSDCを保有するウォレットが必要です。
MCP サーバー
SolEnrichは、Claude Desktop、Claude Code、Cursor向けのMCPエンドポイントを提供します。インストールは不要です。
{
"mcpServers": {
"solenrich": {
"type": "streamable-http",
"url": "https://api.solenrich.com/mcp"
}
}
}
49個のツールを備え、すべてのエンドポイントがMCPツールとして公開されています(ウォレット/トークンのライト版とフル版は、depth/include_holdersの切り替えに統合されています)。主なツール:enrich_wallet、enrich_token、due_diligence、whale_watch、perps_cross_venue_funding、trending_signals、smart_money_flow、check_alerts。
無料デモ
SolEnrichを無料で試せます。Solanaウォレットアドレスまたはトークンミントを貼り付けてください。
curl -X POST https://api.solenrich.com/demo/enrich \
-H "Content-Type: application/json" \
-d '{"address":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"}'
IPアドレスごとに1時間あたり10件の無料クエリを利用できます。ウォレットかトークンかを自動検出し、format: "both"(JSONとLLMの要約)を返します。
ランディングページのインタラクティブデモ:https://solenrich.com
開発
# Install dependencies
bun install
# Start dev server (port 3000)
bun run dev
# Type check
bunx tsc --noEmit
# Run tests (CI runs the unit test files: 500+ tests across 15 files, see .github/workflows/ci.yml)
bun test test/unit.test.ts # core unit tests
bun test test/stonk.test.ts # StonkFun suite (recorded fixtures)
bun run test/test-all-endpoints.ts # live endpoint checks (requires a running server)
bun run test/test-402-production.ts # production paywall verification
bun run agents/solscout/index.ts --target production --mode stress # free 402 check of every route
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
HELIUS_API_KEY | はい | Helius API キー(helius.dev) |
AGENT_WALLET_ADDRESS | はい | 支払い用の Solana ウォレットアドレス |
PAYMENTS_ENABLED | いいえ | x402 ペイウォールを有効にするには "true" に設定します |
FACILITATOR_URL | 支払いを有効にする場合 | x402 ファシリテーターの URL |
UPSTASH_REDIS_REST_URL | いいえ | キャッシュ用の Upstash Redis(設定されていない場合はメモリ内キャッシュにフォールバックします) |
UPSTASH_REDIS_REST_TOKEN | いいえ | Upstash Redis トークン |
JUPITER_API_KEY | いいえ | Jupiter API キー(任意。無料プランでも動作します) |
BIRDEYE_API_KEY | いいえ | Birdeye API キー — 実際の保有者数と、ボラティリティ計算用の日次 OHLCV |
METRICS_TOKEN | いいえ | GET /metrics 用のベアラートークン。本番環境では、設定しない場合メトリクスはロックされます |
EVM_PAY_TO | いいえ | USDC 支払い用の Base アドレス。設定すると、すべての 402 で Base による支払いも提示されます |
DOGFOOD_WALLETS | いいえ | 自分たちのテストエージェントが使用する支払者ウォレットをカンマ区切りで指定します。オーガニック件数と注目度シグナルから除外されます |
デプロイ
Docker(Bun ランタイム)を使用してRailwayにデプロイされています。main ブランチから自動デプロイされます。
ライセンス
MIT
開発者
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。