Solenrich

Official29 tools

by 0xSardius · TypeScript

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

Analyze Solana wallet risk, funding rates, and smart money activity for AI agents.

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.

Parameters (2)

addressstringrequired
Solana wallet address (base58, 32-44 chars)
depthstring
light = basic profile, full = includes DeFi positions and connected wallets

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.

Parameters (2)

mintstringrequired
Token mint address (base58)
include_holdersboolean
Include top 20 holders with balances and % supply

parse_transaction

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

Parameters (1)

signaturestringrequired
Transaction signature (base58, 87-88 chars)

whale_watch

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

Parameters (3)

mintstringrequired
Token mint address (base58)
threshold_usdnumber
Minimum USD value to qualify as whale activity
lookback_hoursnumber
How many hours to look back (1-168)

due_diligence

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

Parameters (1)

mintstringrequired
Token mint address (base58)

wallet_graph

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

Parameters (2)

addressstringrequired
Solana wallet address (base58)
depthnumber
Hop depth (1 or 2)

copy_trade_signals

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

Parameters (2)

addressstringrequired
Solana wallet address (base58)
lookback_daysnumber
Days to analyze (1-90)

batch_enrich

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

Parameters (3)

addressesarrayrequired
Array of Solana addresses (1-25)
typestringrequired
Address type: wallet or token
depthstring
Enrichment depth

compare_tokens

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

Parameters (1)

mintsarrayrequired
2-3 token mint addresses to compare

compare_wallets

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

Parameters (2)

addressesarrayrequired
2-3 wallet addresses to compare
depthstring
Enrichment depth

token_trend

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

Parameters (2)

mintstringrequired
Token mint address (base58)
lookbackstring
Lookback period

wallet_history

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

Parameters (2)

addressstringrequired
Solana wallet address (base58)
lookbackstring
Lookback period

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.

Parameters (2)

addressstringrequired
Solana wallet address (base58)
periodstring
Lookback period

new_tokens

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

Parameters (3)

min_liquidity_usdnumber
Minimum liquidity in USD
max_risk_scorenumber
Maximum risk score (0-1)
limitnumber
Number of tokens to return (1-20)

protocol_profile

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

Parameters (2)

protocolstringrequired
Protocol slug (e.g. "raydium", "orca") or Solana program ID
include_yieldsboolean
Include yield pool data

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".

Parameters (1)

questionstringrequired
Natural language question about a Solana wallet or token

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.

No parameters.

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.

Parameters (1)

addressstringrequired
Solana wallet address

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.

Parameters (1)

addressstringrequired
Hyperliquid EVM (0x) address

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.

Parameters (2)

marketstring
Optional single-coin focus, e.g. HYPE/BTC/ETH
top_tradersinteger
How many top traders to include (default 10)

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.

Parameters (2)

assetstringrequired
Asset to scan
min_yield_apr_pctnumber
Minimum net yield (APR %) for an opportunity to surface

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.

Parameters (1)

lookbackstring
History window

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.

Parameters (3)

marketstringrequired
Asset to query
size_usdnumberrequired
Position size in USD
sidestring
Side being sized

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).

Parameters (2)

marketstringrequired
Asset to query
include_referenceboolean
Include Hyperliquid + dYdX v4 reference rates

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.

Parameters (4)

min_liquidity_usdnumber
Minimum liquidity in USD
max_risk_scorenumber
Maximum risk score (0-1)
limitinteger
Number of tokens to return
include_whale_watchboolean
Include whale flow signal

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.

Parameters (5)

walletsarray
Optional wallet addresses to score (curated default used if omitted)
lookback_daysinteger
Copy-trade lookback window
min_win_ratenumber
Minimum win rate to qualify
top_n_tokensinteger
Max accumulated tokens to surface
include_graphboolean
Include wallet cluster analysis

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.

Parameters (1)

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

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.

Parameters (3)

tokensarray
Token mints to watch (max 10)
walletsarray
Wallet addresses to watch — spot + Jupiter Perps (max 10)
sincestringrequired
ISO 8601 timestamp — return alerts fired since this moment

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.

Parameters (4)

typestring
Entity type to query
addressstring
Optional Solana address — single-entity report when provided
windowstring
Lookback window
limitinteger
Top-N size when address is omitted

README.md11 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 29 endpoints
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, 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 (6 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

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

Intelligence Feed & Signals (3 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
`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 '{"input":{"mints":["JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"],"format":"both"}}'

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.

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"
    }
  }
}

27 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

Parallax Labs

Install

Tools (29)

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.