io.github.0xSardius/solenrich

Official30 toolsLive

by 0xSardius · TypeScript

Solana onchain intelligence for AI agents: wallet risk, due-diligence, perps funding, smart money.

io.github.0xSardius/solenrich (MCP) Server

This MCP server provides Solana onchain data enrichment for AI agents, focused on wallet risk, due-diligence, perps funding, and “smart money.” It supports returning enriched wallet, token, and transaction data as structured JSON for agents, or natural-language briefings for LLMs.

🛠️ Key Features

Solana onchain intelligence: wallet risk and due-diligence
Perps funding and “smart money” enrichment
Outputs enriched wallet, token, and transaction data
Structured JSON for agents and natural-language briefings
Tool count: 30

🚀 Use Cases

AI-agent due-diligence workflows for Solana wallets
Enriching wallet and token context before taking actions
Perps funding analysis for agent decision-making
“Smart money” context gathering for onchain research

⚡ Developer Benefits

Agent-friendly JSON responses for downstream use
LLM-friendly natural-language briefings
Live API available at https://api.solenrich.com/
Agent discovery and health endpoints available

⚠️ Limitations

API is described as including 45 endpoints (44 paid + 1 free)
Limited to Solana onchain data enrichment scenarios based on available description

Topics

ai-agents, defi, mcp, memecoins, micropayments, onchain-data, perps, solana, usdc, x402

Topics

ai-agentsdefimcpmemecoinsmicropaymentsonchain-dataperpssolanausdcx402

Captured live from the server via tools/list.

enrich_wallet

Get a Solana wallet profile: SOL balance, token holdings, DeFi positions, labels (whale, active_trader, defi_user), risk score, and risk level.

Parameters2

address	string	required	Solana wallet address (base58, 32-44 chars)
depth	string	optional	light = basic profile, full = includes DeFi positions and connected wallets

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address (base58, 32-44 chars)"
    },
    "depth": {
      "default": "light",
      "description": "light = basic profile, full = includes DeFi positions and connected wallets",
      "type": "string",
      "enum": [
        "light",
        "full"
      ]
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

enrich_token

Analyze a Solana SPL token: price, market cap, liquidity, holder concentration (top 1/5/10%), slippage estimates at 4 position sizes ($100/$1K/$10K/$100K), risk flags, and Jupiter verification.

Parameters2

mint	string	required	Token mint address (base58)
include_holders	boolean	optional	Include top 20 holders with balances and % supply

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "include_holders": {
      "default": false,
      "description": "Include top 20 holders with balances and % supply",
      "type": "boolean"
    }
  },
  "required": [
    "mint"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

parse_transaction

Parse a Solana transaction: type, protocol, SOL/token transfers, accounts involved, and fee details.

Parameters1

signature

string

required

Transaction signature (base58, 87-88 chars)

Raw schema

{
  "type": "object",
  "properties": {
    "signature": {
      "type": "string",
      "description": "Transaction signature (base58, 87-88 chars)"
    }
  },
  "required": [
    "signature"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

whale_watch

Track top token holders: balances, % supply, buy/sell volumes, accumulation vs distribution signals.

Parameters3

mint	string	required	Token mint address (base58)
threshold_usd	number	optional	Minimum USD value to qualify as whale activity
lookback_hours	number	optional	How many hours to look back (1-168)

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "threshold_usd": {
      "default": 10000,
      "description": "Minimum USD value to qualify as whale activity",
      "type": "number"
    },
    "lookback_hours": {
      "default": 24,
      "description": "How many hours to look back (1-168)",
      "type": "number"
    }
  },
  "required": [
    "mint"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

due_diligence

Comprehensive token research: security audit, holder concentration, whale activity, risk score with level (LOW-CRITICAL), and SAFE/CAUTION/RISKY verdict.

Parameters1

mint

string

required

Token mint address (base58)

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    }
  },
  "required": [
    "mint"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wallet_graph

Map wallet connections: find counterparties, detect clusters of coordinated wallets, and identify suspicious patterns.

Parameters2

address	string	required	Solana wallet address (base58)
depth	number	optional	Hop depth (1 or 2)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address (base58)"
    },
    "depth": {
      "default": 1,
      "description": "Hop depth (1 or 2)",
      "type": "number"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

copy_trade_signals

Analyze a wallet's trading performance: win rate, PnL, consistency, hold time, and smart_money classification.

Parameters2

address	string	required	Solana wallet address (base58)
lookback_days	number	optional	Days to analyze (1-90)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address (base58)"
    },
    "lookback_days": {
      "default": 30,
      "description": "Days to analyze (1-90)",
      "type": "number"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

batch_enrich

Enrich multiple wallets or tokens in a single call (1-25). Returns parallel results.

Parameters3

addresses	array	required	Array of Solana addresses (1-25)
type	string	required	Address type: wallet or token
depth	string	optional	Enrichment depth

Raw schema

{
  "type": "object",
  "properties": {
    "addresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of Solana addresses (1-25)"
    },
    "type": {
      "type": "string",
      "enum": [
        "wallet",
        "token"
      ],
      "description": "Address type: wallet or token"
    },
    "depth": {
      "default": "light",
      "description": "Enrichment depth",
      "type": "string",
      "enum": [
        "light",
        "full"
      ]
    }
  },
  "required": [
    "addresses",
    "type"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_tokens

Side-by-side comparison of 2-3 tokens: price, liquidity, volatility, holder concentration, risk. Rankings and summary picks.

Parameters1

mints

array

required

2-3 token mint addresses to compare

Raw schema

{
  "type": "object",
  "properties": {
    "mints": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2-3 token mint addresses to compare"
    }
  },
  "required": [
    "mints"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_wallets

Side-by-side comparison of 2-3 wallets: portfolio, activity, risk, labels. Rankings and summary picks.

Parameters2

addresses	array	required	2-3 wallet addresses to compare
depth	string	optional	Enrichment depth

Raw schema

{
  "type": "object",
  "properties": {
    "addresses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "2-3 wallet addresses to compare"
    },
    "depth": {
      "default": "light",
      "description": "Enrichment depth",
      "type": "string",
      "enum": [
        "light",
        "full"
      ]
    }
  },
  "required": [
    "addresses"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

token_trend

Token metrics over time: daily snapshots with direction indicators (improving/declining/stable) per metric.

Parameters2

mint	string	required	Token mint address (base58)
lookback	string	optional	Lookback period

Raw schema

{
  "type": "object",
  "properties": {
    "mint": {
      "type": "string",
      "description": "Token mint address (base58)"
    },
    "lookback": {
      "default": "7d",
      "description": "Lookback period",
      "type": "string",
      "enum": [
        "7d",
        "14d",
        "30d"
      ]
    }
  },
  "required": [
    "mint"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wallet_history

Wallet portfolio over time: snapshots with position changes (added/removed holdings) and direction indicators.

Parameters2

address	string	required	Solana wallet address (base58)
lookback	string	optional	Lookback period

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address (base58)"
    },
    "lookback": {
      "default": "7d",
      "description": "Lookback period",
      "type": "string",
      "enum": [
        "7d",
        "14d",
        "30d"
      ]
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_history

Full portfolio time-series for a wallet: daily snapshots of value, balance, holdings, and risk score over 7/14/30 days, plus summary stats (peak, trough, max drawdown, average, change vs period start). For charting and PnL tracking.

Parameters2

address	string	required	Solana wallet address (base58)
period	string	optional	Lookback period

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address (base58)"
    },
    "period": {
      "default": "7d",
      "description": "Lookback period",
      "type": "string",
      "enum": [
        "7d",
        "14d",
        "30d"
      ]
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

new_tokens

Discover recently launched Solana tokens. Filters by liquidity and risk score, ranked safest first.

Parameters3

min_liquidity_usd	number	optional	Minimum liquidity in USD
max_risk_score	number	optional	Maximum risk score (0-1)
limit	number	optional	Number of tokens to return (1-20)

Raw schema

{
  "type": "object",
  "properties": {
    "min_liquidity_usd": {
      "default": 1000,
      "description": "Minimum liquidity in USD",
      "type": "number"
    },
    "max_risk_score": {
      "default": 0.8,
      "description": "Maximum risk score (0-1)",
      "type": "number"
    },
    "limit": {
      "default": 10,
      "description": "Number of tokens to return (1-20)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

protocol_profile

DeFi protocol analytics: TVL, yield pools, on-chain activity, health signals. Supports Raydium, Orca, marginfi, Drift, Jupiter, Kamino, Marinade, Jito, and more.

Parameters2

protocol	string	required	Protocol slug (e.g. "raydium", "orca") or Solana program ID
include_yields	boolean	optional	Include yield pool data

Raw schema

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol slug (e.g. \"raydium\", \"orca\") or Solana program ID"
    },
    "include_yields": {
      "default": true,
      "description": "Include yield pool data",
      "type": "boolean"
    }
  },
  "required": [
    "protocol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query

Ask a plain English question about any Solana wallet, token, or market. Single-intent routes to one enricher; compound intents chain 2-3 in parallel and return a unified briefing. Examples: "should I buy <mint>?" (DD + trend + whales), "wallet deep dive on <addr>" (profile + history + perps), "is <mint> safe?", "what's trending right now", "SOL-PERP funding rate".

Parameters1

question

string

required

Natural language question about a Solana wallet or token

Raw schema

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Natural language question about a Solana wallet or token"
    }
  },
  "required": [
    "question"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perps_market_structure

Per-market OI, utilization, borrow APR, skew, OI caps, and health flags across Jupiter Perps SOL/BTC/ETH. Reads on-chain Anchor accounts directly.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perps_trader_profile

Open positions across BOTH Jupiter Perps and Adrena for a wallet. Per-venue breakdown plus combined totals. Each position tagged with venue. Trader classification (scalper/swing/position), directional bias, multi-venue exposure flag, and risk flags (high leverage, approaching liquidation, concentrated market). Adrena PnL needs mark prices for jitoSOL/WBTC/BONK and is null when unavailable.

Parameters1

address

string

required

Solana wallet address

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Solana wallet address"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

hyperliquid_trader_profile

Live Hyperliquid perp positions for an EVM (0x) address, read from HL's public on-chain state. Per-position side, leverage, notional, entry, unrealized PnL, distance-to-liquidation, and risk flags. Account value, directional bias, profile (directional/market-neutral/diversified), and realized+unrealized PnL over week/month/all-time. The building block for HL smart-money tracking.

Parameters1

address

string

required

Hyperliquid EVM (0x) address

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "Hyperliquid EVM (0x) address"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

hyperliquid_smart_money

Where Hyperliquid smart money is positioned. Filters the HL leaderboard to consistent directional traders (excludes market-makers + dust), then aggregates their live positions into a per-coin consensus (long/short counts, net notional, bias, conviction) plus a top-trader drill-down. Optionally focus one coin via `market`. A positioning signal, not a trade — use as confluence/risk context, not a standalone entry.

Parameters2

market	string	optional	Optional single-coin focus, e.g. HYPE/BTC/ETH
top_traders	integer	optional	How many top traders to include (default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "description": "Optional single-coin focus, e.g. HYPE/BTC/ETH",
      "type": "string"
    },
    "top_traders": {
      "description": "How many top traders to include (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perps_basis_signal

Computes perp mark vs spot price across venues and surfaces actually-earnable yield. Funding-rate venues (HL, dYdX) generate real yield; pool perps (Jupiter, Adrena) flagged as not viable because they charge borrow on both sides. Returns per-venue trade + filtered opportunities + best trade.

Parameters2

asset	string	required	Asset to scan
min_yield_apr_pct	number	optional	Minimum net yield (APR %) for an opportunity to surface

Raw schema

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "enum": [
        "SOL",
        "BTC",
        "ETH",
        "BONK"
      ],
      "description": "Asset to scan"
    },
    "min_yield_apr_pct": {
      "default": 5,
      "description": "Minimum net yield (APR %) for an opportunity to surface",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    }
  },
  "required": [
    "asset"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perps_market_trend

Per-symbol (SOL/BTC/ETH) deltas for mark price, total open interest, long/short skew, utilization, and borrow APR over 7/14/30 days. Direction indicators per metric and per market. Overall direction excludes mark price. Use for regime detection — bots that adjust behavior based on whether markets are growing, stressed, or rebalancing.

Parameters1

lookback

string

optional

History window

Raw schema

{
  "type": "object",
  "properties": {
    "lookback": {
      "default": "7d",
      "description": "History window",
      "type": "string",
      "enum": [
        "7d",
        "14d",
        "30d"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perps_venue_comparison

Where to trade this market at this size. Builds on cross-venue funding with spot slippage, per-venue fee, OI cap headroom, and total entry cost. Returns rankings + recommendation with warnings.

Parameters3

market	string	required	Asset to query
size_usd	number	required	Position size in USD
side	string	optional	Side being sized

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "enum": [
        "SOL",
        "BTC",
        "ETH",
        "BONK"
      ],
      "description": "Asset to query"
    },
    "size_usd": {
      "type": "number",
      "minimum": 100,
      "maximum": 10000000,
      "description": "Position size in USD"
    },
    "side": {
      "default": "long",
      "description": "Side being sized",
      "type": "string",
      "enum": [
        "long",
        "short"
      ]
    }
  },
  "required": [
    "market",
    "size_usd"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

perps_cross_venue_funding

Compare borrow/funding APR + OI across Solana on-chain venues (Jupiter Perps, Adrena) and cross-chain reference (Hyperliquid, dYdX v4). Returns best entry per side, basis vs Hyperliquid, and arbitrage opportunities. SOL/BTC/ETH/BONK supported (with venue-specific availability).

Parameters2

market	string	required	Asset to query
include_reference	boolean	optional	Include Hyperliquid + dYdX v4 reference rates

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "enum": [
        "SOL",
        "BTC",
        "ETH",
        "BONK"
      ],
      "description": "Asset to query"
    },
    "include_reference": {
      "default": true,
      "description": "Include Hyperliquid + dYdX v4 reference rates",
      "type": "boolean"
    }
  },
  "required": [
    "market"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

trending_signals

Ranked list of Solana tokens worth paying attention to right now. Composes DexScreener trending + risk scoring + whale-flow into a composite signal with reasoning.

Parameters4

min_liquidity_usd	number	optional	Minimum liquidity in USD
max_risk_score	number	optional	Maximum risk score (0-1)
limit	integer	optional	Number of tokens to return
include_whale_watch	boolean	optional	Include whale flow signal

Raw schema

{
  "type": "object",
  "properties": {
    "min_liquidity_usd": {
      "default": 10000,
      "description": "Minimum liquidity in USD",
      "type": "number"
    },
    "max_risk_score": {
      "default": 0.7,
      "description": "Maximum risk score (0-1)",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "limit": {
      "default": 10,
      "description": "Number of tokens to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "include_whale_watch": {
      "default": true,
      "description": "Include whale flow signal",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

smart_money_flow

Where high-performing Solana wallets are moving. Scores seed wallets by copy-trade metrics, surfaces tokens they're accumulating, and maps wallet clusters.

Parameters5

wallets	array	optional	Optional wallet addresses to score (curated default used if omitted)
lookback_days	integer	optional	Copy-trade lookback window
min_win_rate	number	optional	Minimum win rate to qualify
top_n_tokens	integer	optional	Max accumulated tokens to surface
include_graph	boolean	optional	Include wallet cluster analysis

Raw schema

{
  "type": "object",
  "properties": {
    "wallets": {
      "description": "Optional wallet addresses to score (curated default used if omitted)",
      "maxItems": 30,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "lookback_days": {
      "default": 14,
      "description": "Copy-trade lookback window",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    },
    "min_win_rate": {
      "default": 0.55,
      "description": "Minimum win rate to qualify",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "top_n_tokens": {
      "default": 10,
      "description": "Max accumulated tokens to surface",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "include_graph": {
      "default": true,
      "description": "Include wallet cluster analysis",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

smart_money_trenches

Which proven-winner wallets are aping fresh (<6h) memecoin launches right now, and what are they buying? Vetted realized-PnL winner seed set (bot-filtered), recent buys overlaid against token launch times, ranked by distinct smart buyers + recency. Pre-ape attention signal.

Parameters4

hours_back	integer	optional	How far back to scan seed-wallet buys (hours)
max_token_age_hours	number	optional	Max token age in hours to count as fresh
min_buyers	integer	optional	Min distinct smart buyers per token
limit	integer	optional	Max tokens to return

Raw schema

{
  "type": "object",
  "properties": {
    "hours_back": {
      "default": 12,
      "description": "How far back to scan seed-wallet buys (hours)",
      "type": "integer",
      "minimum": 1,
      "maximum": 48
    },
    "max_token_age_hours": {
      "default": 6,
      "description": "Max token age in hours to count as fresh",
      "type": "number",
      "minimum": 1,
      "maximum": 72
    },
    "min_buyers": {
      "default": 1,
      "description": "Min distinct smart buyers per token",
      "type": "integer",
      "minimum": 1,
      "maximum": 14
    },
    "limit": {
      "default": 10,
      "description": "Max tokens to return",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

feed_latest

Daily intelligence brief — pre-computed ranking of trending Solana tokens with composite-signal scoring. Cached 24h, lazy-populated on cache miss. Pass `since` (ISO 8601) to short-circuit on no-change polls.

Parameters1

since

string

optional

Optional ISO 8601 timestamp of last successful poll. If brief is not newer, response sets unchanged=true with empty payload.

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Optional ISO 8601 timestamp of last successful poll. If brief is not newer, response sets unchanged=true with empty payload.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_alerts

Poll-based event detection covering spot + Jupiter Perps. Pass a watchlist (token mints + wallet addresses) and a since timestamp; receive alerts graded by severity. Spot alerts: price spike/drop, risk change, whale flow, concentration shift, portfolio value change, position add/remove. Jupiter Perps alerts per wallet: position opened, position closed, at-risk (high leverage or underwater), liquidation approaching, PnL swing. Stateless — caller owns the cursor.

Parameters3

tokens	array	optional	Token mints to watch (max 10)
wallets	array	optional	Wallet addresses to watch — spot + Jupiter Perps (max 10)
since	string	required	ISO 8601 timestamp — return alerts fired since this moment

Raw schema

{
  "type": "object",
  "properties": {
    "tokens": {
      "default": [],
      "description": "Token mints to watch (max 10)",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "wallets": {
      "default": [],
      "description": "Wallet addresses to watch — spot + Jupiter Perps (max 10)",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "since": {
      "type": "string",
      "description": "ISO 8601 timestamp — return alerts fired since this moment"
    }
  },
  "required": [
    "since"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

consensus_signal

What tokens or wallets are being queried by other agents right now. Proprietary data derived from SolEnrich's own query stream. Pass `address` for that entity's rank/percentile/trend; omit it for top-N. Windows: 1h, 6h, 24h.

Parameters4

type	string	optional	Entity type to query
address	string	optional	Optional Solana address — single-entity report when provided
window	string	optional	Lookback window
limit	integer	optional	Top-N size when address is omitted

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "default": "token",
      "description": "Entity type to query",
      "type": "string",
      "enum": [
        "token",
        "wallet"
      ]
    },
    "address": {
      "description": "Optional Solana address — single-entity report when provided",
      "type": "string"
    },
    "window": {
      "default": "1h",
      "description": "Lookback window",
      "type": "string",
      "enum": [
        "1h",
        "6h",
        "24h"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Top-N size when address is omitted",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md20 KBView on GitHub

SolEnrich

Solana onchain data enrichment agent. Accepts USDC micropayments via x402 and returns enriched wallet, token, and transaction data — structured JSON for agents or natural language briefings for LLMs.

Live API: https://api.solenrich.com/ Landing Page: https://solenrich.com Docs (agent-readable): https://api.solenrich.com/docs

Quick Start

bash

# Health check
curl https://api.solenrich.com/health

# Agent card (A2A discovery)
curl https://api.solenrich.com/.well-known/agent.json

# List all 48 endpoints (47 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"}'

Endpoints

All paid endpoints accept POST requests to /entrypoints/{key}/invoke with a JSON body containing an input object. Without a valid x402 payment header, endpoints return HTTP 402 with payment instructions.

Core (5 endpoints)

Endpoint	Price	Input	Description
`enrich-wallet-light`	$0.002	`address`, `format`	SOL balance, token holdings, NFT breakdown, labels, risk score
`enrich-wallet-full`	$0.005	`address`, `format`	+ DeFi positions, connected wallets, enhanced tx history
`enrich-token-light`	$0.002	`mint`, `format`	Price (median of 3 sources), market cap, volume, liquidity, risk flags
`enrich-token-full`	$0.004	`mint`, `format`	+ Top 20 holders, HHI concentration, volatility metrics
`parse-transaction`	$0.001	`signature`, `format`	Type detection, protocol identification, transfer breakdown

Premium (5 endpoints)

Endpoint	Price	Input	Description
`whale-watch`	$0.008	`mint`, `format`	Top holders with accumulation/distribution tracking
`batch-enrich`	$0.015	`addresses[]`, `type`, `depth`, `format`	Parallel enrichment of up to 25 wallets or tokens
`wallet-graph`	$0.010	`address`, `depth`, `format`	Transaction connection mapping and cluster detection
`copy-trade-signals`	$0.010	`address`, `format`	PnL, win rate, Sharpe/Sortino ratios, max drawdown
`due-diligence`	$0.020	`mint`, `format`	Composite risk report with SAFE / CAUTION / RISKY verdict

Comparison (2 endpoints)

Endpoint	Price	Input	Description
`compare-tokens`	$0.006	`mints[]` (2-3), `format`	Side-by-side: price, liquidity, volatility, HHI, risk. Rankings + summary
`compare-wallets`	$0.006	`addresses[]` (2-3), `depth`, `format`	Side-by-side: portfolio, activity, risk, labels. Rankings + summary

Temporal (3 endpoints)

Endpoint	Price	Input	Description
`token-trend`	$0.006	`mint`, `lookback`, `format`	Token metrics over time — daily snapshots with improving/declining/stable direction per metric
`wallet-history`	$0.006	`address`, `lookback`, `format`	Portfolio value, SOL balance, risk score deltas + position changes across daily snapshots
`portfolio-history`	$0.006	`address`, `period`, `format`	Full portfolio time-series (7/14/30d) with peak, trough, max drawdown, change vs start

Discovery & Protocol (2 endpoints)

Endpoint	Price	Input	Description
`new-tokens`	$0.012	`min_liquidity_usd`, `max_risk_score`, `limit`, `format`	Recently launched tokens, enriched + risk-scored, safest first
`protocol-profile`	$0.008	`protocol`, `include_yields`, `format`	Protocol TVL, yields, on-chain activity, health signals, automated-activity %

Perps Intelligence (8 endpoints)

Endpoint	Price	Input	Description
`perps-market-structure`	$0.012	`format`	Jupiter Perps OI, utilization, borrow APR, skew, health flags for SOL/BTC/ETH
`perps-trader-profile`	$0.010	`address`, `format`	Multi-venue (Jupiter + Adrena) open positions, leverage, PnL, trader classification
`perps-cross-venue-funding`	$0.015	`market`, `include_reference`, `format`	Funding/borrow APR + OI across Jupiter, Adrena, Hyperliquid, dYdX — best entry per side, arbitrage spreads
`perps-venue-comparison`	$0.020	`market`, `side`, `size_usd`, `format`	Where to trade at this size: slippage, fees, OI headroom, total entry cost, recommendation
`perps-basis-signal`	$0.015	`asset`, `min_yield_apr_pct`, `format`	Net-yield-after-borrow basis trade scanner — actually-earnable yield per venue
`perps-market-trend`	$0.008	`lookback`, `format`	Per-market deltas (price, OI, skew, utilization, borrow APR) over 7/14/30d — regime detection
`hyperliquid-trader-profile`	$0.012	`address` (0x), `format`	Hyperliquid live positions, leverage, liquidation distance, risk flags, week/month/all-time PnL
`hyperliquid-smart-money`	$0.05	`market`, `top_traders`, `format`	Leaderboard funnel → consistency-gated traders → per-coin positioning consensus + top-trader drill-down

Orchestration (2 endpoints)

Endpoint	Price	Input	Description
`trending-signals`	$0.050	`min_liquidity_usd`, `max_risk_score`, `limit`, `format`	Composite ranking of trending tokens: discovery + whale-watch + risk scoring, with reasoning
`smart-money-flow`	$0.100	`wallets[]`, `min_win_rate`, `lookback_days`, `format`	Scores seed wallets, filters to winners, surfaces tokens they're accumulating + clusters

Trenches — Memecoin Intelligence (5 endpoints)

Endpoint	Price	Input	Description
`smart-money-trenches`	$0.05	`hours_back`, `max_token_age_hours`, `min_buyers`, `limit`, `format`	Which proven-winner wallets are aping fresh (<6h) launches right now — vetted realized-PnL seed set, bot-guarded, ranked by distinct smart buyers + recency
`runner-scan`	$0.04	`max_token_age_hours`, `min_liquidity_usd`, `min_volume_h1_usd`, `limit`, `format`	Which fresh tokens are accelerating right now — buy-rate acceleration (5m vs 1h, 1h vs 6h), buy pressure, volume/price velocity, holder growth, liquidity trend. Stages RUNNING / IGNITING / PARABOLIC_LATE / FADING with a 0–1 score. Flags already-ran tokens as entry risk and LP pulls as rugs
`trenches-scan`	$0.08	`max_token_age_hours`, `min_liquidity_usd`, `limit`, `format`	All three trenches signals in one call — on-chain velocity × proven-winner buys × agent attention, composited into a ranked list with confluence counts, per-token reasoning, and HIGH_CONFLUENCE / MODERATE / SINGLE_SIGNAL verdicts
`trenches-check`	$0.03	`mint`, `format`	The suite pointed at ONE token — before you ape, run the check. Same three legs as trenches-scan but targeted at your candidate: verdict + reasoning + per-leg detail. Pairs with due-diligence for a full pre-entry read
`exit-signal`	$0.04	`mint`, `entry_price_usd`, `format`	The sell-side verdict for a token you hold — EXIT / DERISK / HOLD with a 0–1 exit score. Sell pressure, buy-rate deceleration, volume fade, distribution-into-strength, top-holder flow (distributing vs accumulating whales), liquidity trend, holder churn. Rug triggers (LP pull, active dump) override everything. Works on tokens of any age

Collectibles / RWA (1 endpoint)

Endpoint	Price	Input	Description
`gacha-ev-scan`	$0.02	`machine`, `franchise`, `exit_strategy`, `min_edge_pct`, `format`	Jupiter Gacha (Collector Crypt) pack EV scan — gross insured EV vs the guaranteed instant-buyback floor (85–93%, ≤72h) vs a marketplace sale (−2% fee, fill-risk). POSITIVE_EV / HOUSE_EDGE / NEGATIVE_EV verdict per machine — the realizable EV the platform hides behind its gross-EV headline

StonkFun — Quote-Paired & Reward Coins (5 endpoints, 1 free)

Coins launched on stonkfun.xyz are priced against a quote asset (xStocks such as NVDAX/SPYX/TSLAX, Backpack pre-stocks, currencies, custom mints). Reward-mode coins carry a Token-2022 transfer tax (100 or 300 bps) paid to holders in the quote token. These endpoints read the tax config from the chain, score whether it reaches holders, compute holder yield, screen the whole reward-coin set, and preflight a self-built LaunchLab launch before it is broadcast.

Endpoint	Price	Input	Description
`stonk-pairs`	free	`category`, `launchable_only`, `format`	Quote assets a launch can be paired against, normalized categories, `is_agent_launchable` flag (launchable + LaunchLab-ready + allowed category). Call first: a launch `quoteMint` must be one of these
`stonk-reward-risk`	$0.005	`mint`, `format`	Payout status — `PAYING` (holders paid in the last 24h), `STALE`, `NEVER`, `NOT_REWARD` — plus `trading_cost` (tax bps, round-trip %) and a 0–100 health score read from the chain: fee bps + cap, withdraw authority (must be StonkFun's distributor), fee mutability, distributions + recency, flywheel, holders + concentration, quote category, age
`stonk-yield-batch`	$0.05	`mints` (up to 25) or screener filters, `limit` (≤25), `format`	`stonk-yield` for up to 25 coins in one call, from the index in milliseconds: 7d / 30d / lifetime yield per coin with reward asset, market cap, holders, last payout. Cheaper than `stonk-screener` + one `stonk-yield` per coin
`stonk-alerts`	$0.02	`mints` (1–25), `since`, `min_holders_change_pct`, `stale_after_hours`, `format`	What changed for your reward coins since your last check: payout landed, payout went stale, stopped trading, holders moved, rewards paid since. Plus current payout status per coin. From the index in milliseconds; poll it and pass `checked_at` back as `since`
`stonk-yield`	$0.005	`mint`, `format`	Trailing 7d / 30d / lifetime holder yield — rewards in the quote asset, priced in USD, over average market cap; annualized with a caution flag under 7 days. Plus quote exposure: the holder is long the coin and its quote asset
`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`	Every reward coin from a 10-minute ingest, served from memory. Per row: `payout_status`, hours since last payout, `live` (traded AND paid in 24h), `round_trip_pct` tax cost, holders, yields, volume, mcap. Sort by `volume24h` (default), `lastPayout`, `holders`, `priceChange24h`, `yield7d`, `yield30d`, `rewardsUsd`
`stonk-gems`	$0.03	`quote_mint`, `category`, `max_age_days`, `min_holders`, `max_market_cap_usd`, `limit`, `format`	Gem finder: ranks reward coins 0–100 on recent holder payout, holders, mcap headroom, 24h turnover, age, momentum, quote strength, flywheel. Stages `GEM` / `WATCH` / `NOISE` / `DEAD` with reasons and warnings per coin. "What should I look at on StonkFun right now?"
`stonk-launch-intel`	$0.02	`category`, `min_coins`, `sort`, `limit`, `format`	What to launch and against what. Per quote asset: launches (24h/7d), share trading today, share paying today, survival past day 3, median holders + mcap, 100 vs 300 bps tax mix with trading/paying rates, crowding, 0–100 demand score, plus overall stats and plain recommendations
`stonk-quote`	$0.005	`mint`, `size_usd`, `hold_days`, `format`	Cost and payback of one trade at one size, no swap: entry/exit cost (tax + price impact), round-trip % and breakeven move, pro-rata payout share with dust warning, expected payout over the hold from real yield history, `PAYS` / `MARGINAL` / `COSTS` / `NOT_PAYING` with breakeven hold days
`stonk-launch-preflight`	$0.25	`unsigned_transaction`, `quote_mint`, `mode`, `launch_params`, `format`	Decodes the LaunchLab initialize instruction and diffs every parameter against StonkFun's `/launchlab/pricing` — GlobalConfig, platform id per mode, curve, supply, totalSellA, raise, 6-decimal Token-2022 base mint, quote token program, curve-rule account last, and the reward-mode transfer fee (catches Raydium's `transferFeeBasePoints` / `maxinumFee` spelling). Returns `ok`, `mismatches[{field, expected, actual, fix}]`, `warnings`. A mismatched pool is never adopted: the tax goes to nobody

Intelligence Feed & Signals (4 endpoints)

Endpoint	Price	Input	Description
`feed-latest`	$0.005	`since`, `format`	Daily intelligence brief — pre-computed trending ranking, cached 24h, built for recurring polling
`consensus-signal`	$0.005	`address`/`type` or `limit`, `window`, `format`	What other agents are querying right now — proprietary attention signal from our request stream
`attention-momentum`	$0.02	`window`, `limit`, `format`	Tokens ranked by acceleration of agent attention, with price divergence: early_signal (attention up, price flat) / distribution_risk (attention cooling, price pumping)
`check-alerts`	$0.008	`tokens[]`, `wallets[]`, `since`, `criteria`, `format`	Poll-based alerts: price spikes, whale flows, risk changes + perps events (position add/close, liquidation approaching, PnL swings)

Natural Language (1 endpoint)

Endpoint	Price	Input	Description
`query`	$0.003	`question`, `format`	Plain English questions routed to the right enricher

Example Request

bash

curl -X POST https://api.solenrich.com/entrypoints/compare-tokens/invoke \
  -H "Content-Type: application/json" \
  -d '{"mints":["JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"format":"both"}'

Request bodies are flat JSON matching each endpoint's schema in /openapi.json. A {"input": {...}} envelope is also accepted.

Output Formats

Every endpoint accepts a format parameter:

json — Structured data for agent-to-agent consumption
llm — Natural language briefing (markdown) for LLM context windows
both — JSON data with an additional llm_summary field

Scoring Methodology

All scoring is deterministic on-chain logic — no LLM inference anywhere in the pipeline.

Wallet Risk Score (0.0 - 1.0)

Seven additive factors from on-chain activity:

Factor	Weight
High transaction concentration (few counterparties)	+0.15
Low transaction diversity	+0.10
New wallet (< 30 days old)	+0.15
Bot-like patterns (high frequency, repetitive)	+0.20
Interactions with known risky programs	+0.15
Airdrop farming signals (many small token accounts)	+0.10
Low protocol diversity (< 2 protocols)	+0.10

Risk Levels: LOW (< 0.25) | MODERATE (0.25-0.50) | ELEVATED (0.50-0.65) | HIGH (0.65-0.80) | CRITICAL (> 0.80)

HHI (Herfindahl-Hirschman Index)

Holder concentration metric from top 20 on-chain holders:

< 1500 — Well distributed
1500-2500 — Moderately concentrated
> 2500 — Highly concentrated

Price Volatility

Computed from DexScreener multi-timeframe data (zero extra API calls):

LOW — daily std < 3%
MODERATE — 3-8%
HIGH — 8-15%
EXTREME — > 15%

Token Pricing

Median of up to 3 sources (Helius DAS, DexScreener, Jupiter). Median resists outliers from any single DEX.

Architecture

code

Client → x402 Paywall → Entrypoint Router → Enrichment Engine → Format Router → Response

Data Sources

Source	Usage
Helius	DAS API (assets, token accounts), enhanced transaction parsing, RPC
DexScreener	Token prices, market data, liquidity, OHLCV
DeFi Llama	Protocol TVL, yield data
Jupiter	Token prices (cross-reference), metadata, verification status, perps quotes
Birdeye	Real holder counts, daily OHLCV for volatility
Solana RPC	SOL balances, mint info, top 20 holders, Jupiter Perps + Adrena on-chain accounts
Hyperliquid + dYdX v4	Cross-chain perps reference (funding rates, basis)

Entity Labeling

20+ known Solana addresses auto-tagged across all enrichment results: CEX wallets (Binance, Coinbase), protocol addresses (Raydium, Orca, Jupiter), bridges, and foundations.

NFT Classification

Most non-fungible assets on a Solana wallet are unsolicited compressed drops, so a raw NFT count overstates collecting activity. One measured wallet held 118 non-fungibles: 15 were real holdings and 103 were airdrops, several of them drainer bait.

Wallet enrichment returns nft_summary with three buckets that sum to nft_count:

Bucket	Meaning
`collected`	Uncompressed and not spam-flagged. Minting these costs rent per asset, so they are usually bought or minted deliberately.
`airdropped`	Compressed and not spam-flagged. Cheap to mint in bulk, so usually sent unsolicited.
`suspected_spam`	Name or description matches claim bait, an embedded domain, or invisible filter-evasion characters.

nft_collections lists the largest collections, real holdings first. distinct_collections counts only collected holdings in a named collection.

Spam detection is pattern matching on names and descriptions, applied to compressed assets only. Treat it as a signal, not a verdict — a legitimate compressed drop with promotional wording can be flagged. The nft_collector label requires 10 or more collected NFTs, so it no longer fires on airdrop volume.

Agent Skill

One line installs the SolEnrich skill into Claude Code, Cursor, Codex and other agents that read Agent Skills. It teaches the agent which endpoint answers which question, how to pay per call over x402, and the trade and StonkFun workflows:

bash

npx skills add 0xSardius/solenrich --skill solenrich

Source: skills/solenrich/. Listed on skills.sh. Data calls are paid (x402, USDC on Solana or Base); the agent needs a wallet with USDC.

MCP Server

SolEnrich exposes an MCP endpoint for Claude Desktop, Claude Code, and Cursor. No install required:

json

{
  "mcpServers": {
    "solenrich": {
      "type": "streamable-http",
      "url": "https://api.solenrich.com/mcp"
    }
  }
}

46 tools — every endpoint is exposed as an MCP tool (wallet/token light+full variants fold into depth/include_holders toggles). Highlights: enrich_wallet, enrich_token, due_diligence, whale_watch, perps_cross_venue_funding, trending_signals, smart_money_flow, check_alerts.

Free Demo

Try SolEnrich without payment — paste any Solana wallet address or token mint:

bash

curl -X POST https://api.solenrich.com/demo/enrich \
  -H "Content-Type: application/json" \
  -d '{"address":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"}'

10 free queries per IP per hour. Auto-detects wallet vs token. Returns format: "both" (JSON + LLM summary).

Interactive demo on the landing page: https://solenrich.com

Development

bash

# Install dependencies
bun install

# Start dev server (port 3000)
bun run dev

# Type check
bunx tsc --noEmit

# Run tests
bun test test/unit.test.ts                # 138 unit tests
bun run test/test-all-endpoints.ts        # 55 endpoint tests (requires local server)
bun run test/test-402-production.ts       # Production paywall verification

Environment Variables

Variable	Required	Description
`HELIUS_API_KEY`	Yes	Helius API key (helius.dev)
`AGENT_WALLET_ADDRESS`	Yes	Solana wallet address for payments
`PAYMENTS_ENABLED`	No	Set to `"true"` to enable x402 paywall
`FACILITATOR_URL`	If payments	x402 facilitator URL
`UPSTASH_REDIS_REST_URL`	No	Upstash Redis for caching (falls back to in-memory)
`UPSTASH_REDIS_REST_TOKEN`	No	Upstash Redis token
`JUPITER_API_KEY`	No	Jupiter API key (optional, free tier works)
`BIRDEYE_API_KEY`	No	Birdeye API key — real holder counts + daily OHLCV for volatility
`METRICS_TOKEN`	No	Bearer token for `GET /metrics`; without it metrics are locked in production

Deployment

Deployed on Railway with Docker (Bun runtime). Auto-deploys from main branch.

License

MIT

Built by

@0xSardius

Install

Tools (30)

enrich_walletenrich_tokenparse_transactionwhale_watchdue_diligencewallet_graphcopy_trade_signalsbatch_enrich

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.solenrich.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "solenrich": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.solenrich.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.0xSardius/solenrich (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

Topics

enrich_wallet

enrich_token

parse_transaction

whale_watch

due_diligence

wallet_graph

copy_trade_signals

batch_enrich

compare_tokens

compare_wallets

token_trend

wallet_history

portfolio_history

new_tokens

protocol_profile

query

perps_market_structure

perps_trader_profile

hyperliquid_trader_profile

hyperliquid_smart_money

perps_basis_signal

perps_market_trend

perps_venue_comparison

perps_cross_venue_funding

trending_signals

smart_money_flow

smart_money_trenches

feed_latest

check_alerts

consensus_signal

SolEnrich

Quick Start

Endpoints

Core (5 endpoints)

Premium (5 endpoints)

Comparison (2 endpoints)

Temporal (3 endpoints)

Discovery & Protocol (2 endpoints)

Perps Intelligence (8 endpoints)

Orchestration (2 endpoints)

Trenches — Memecoin Intelligence (5 endpoints)

Collectibles / RWA (1 endpoint)

StonkFun — Quote-Paired & Reward Coins (5 endpoints, 1 free)

Intelligence Feed & Signals (4 endpoints)

Natural Language (1 endpoint)

Example Request

Output Formats

Scoring Methodology

Wallet Risk Score (0.0 - 1.0)

HHI (Herfindahl-Hirschman Index)

Price Volatility

Token Pricing

Architecture

Data Sources

Entity Labeling

NFT Classification

Agent Skill

MCP Server

Free Demo

Development

Environment Variables

Deployment

License

Built by

Install

Remote endpoint

Related servers