# SolEnrich — full reference for LLMs

> Onchain intelligence API for Solana agents and LLMs. 45 paid endpoints and 1 free. Pay per call with USDC over x402 on Solana or Base, or by card via MPP/Stripe. No API key. Every verdict is deterministic: no LLM runs inside SolEnrich, so a briefing costs the same as JSON and never hallucinates.

## How to call

- Every endpoint is `POST https://api.solenrich.com/entrypoints/{key}/invoke` with a JSON body. A flat body works (`{"mint": "...", "format": "llm"}`); so does `{"input": {...}}`.
- `format`: `json` (default, typed fields), `llm` (a short deterministic briefing), or `both`.
- Without payment the response is HTTP 402 with `pricing`, `how_to_pay`, and `all_endpoints` (every key with its price). Pay with an x402 client (`@x402/fetch` + `@x402/svm` for Solana, `@x402/evm` for Base) or the Solana Foundation `pay` CLI (`pay curl ...`).
- Free without a wallet: `GET /docs`, `GET /llms.txt`, `GET /openapi.json`, `GET /.well-known/x402`, `GET /status`, `POST /demo/enrich` (10 per hour), and `POST /entrypoints/stonk-pairs/invoke`.
- Results are cached server-side from 30 seconds to 10 minutes by data type. Re-polling inside the window pays for the same answer.
- Every response carries `caveats` (which legs degraded) and `next_steps` (the next call to make). Never drop the caveats.

## Networks

- Solana mainnet (CAIP-2 `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`), USDC `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`
- Base mainnet (CAIP-2 `eip155:8453`), USDC `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` — same price per call, the payer picks the network

## Endpoints

## StonkFun reward coins

Token-2022 coins paired to xStocks, pre-stocks, ZEC and other quote assets; a transfer tax pays holders in the quote. Find, cost, and time a stonk trade, or decide what to launch.

### stonk-pairs — free

POST https://api.solenrich.com/entrypoints/stonk-pairs/invoke

List StonkFun quote pairs an agent can launch against (free)

FREE. Quote assets a StonkFun launch can be paired against — xStocks, pre-stocks, currencies, custom mints — with normalized categories and an is_agent_launchable flag (launchable + LaunchLab-ready + allowed category). Cached 5 minutes. Call first: a launch quoteMint must be one of these.

Inputs:
- `category` string (one of "xstock", "prestock", "currency", "leverage", "solana", "collectible", "custom")
- `launchable_only` boolean (default false) — Only pairs with is_agent_launchable=true
- `format` string (default "json", one of "json", "llm", "both")

### stonk-gems — $0.03 USDC

POST https://api.solenrich.com/entrypoints/stonk-gems/invoke

Find gems on StonkFun: early, real, paying reward coins

Gem finder over every StonkFun reward coin: which look early, real, and paying? Scores 0-100 from the 10-minute index — recent holder payout, holders (found but not saturated), market cap headroom, 24h turnover, age, momentum (not yet parabolic), quote-asset strength, flywheel. Stages GEM / WATCH / NOISE / DEAD with plain reasons and warnings per coin, plus the round-trip tax cost. Filters: quote_mint, category, max_age_days, min_holders, max_market_cap_usd. Milliseconds.

Inputs:
- `quote_mint` string
- `category` string (one of "xstock", "prestock", "currency", "leverage", "solana", "collectible", "custom")
- `max_age_days` number (default 14, range 0–90)
- `min_holders` integer (default 25, range 0–…)
- `max_market_cap_usd` number (default 5000000, range 0–…)
- `limit` integer (default 15, range 1–50)
- `format` string (default "json", one of "json", "llm", "both")

### stonk-screener — $0.01 USDC

POST https://api.solenrich.com/entrypoints/stonk-screener/invoke

Screen every StonkFun reward coin: payout status, live flag, tax cost

Screen every StonkFun reward coin from a 10-minute index. Per row: payout status (PAYING / STALE / NEVER), hours since last payout, live flag (traded AND paid in 24h), round-trip transfer-tax cost, holders, rewards USD, yields, volume, mcap, 24h change. Filters: quote_mint, category, holders, age, volume, market cap, paying_only, live_only. Sort by volume24h (default), lastPayout, holders, priceChange24h, or yield. "Which coins on NVDAX paid holders today?" is one call.

Inputs:
- `quote_mint` string
- `category` string (one of "xstock", "prestock", "currency", "leverage", "solana", "collectible", "custom")
- `min_holders` integer (range 0–…)
- `min_age_days` number (range 0–…)
- `max_age_days` number (range 0–…)
- `min_volume_24h_usd` number (range 0–…)
- `max_market_cap_usd` number (range 0–…)
- `paying_only` boolean (default false) — Only coins that paid holders in the last 24h
- `live_only` boolean (default false) — Only coins that traded AND paid in the last 24h
- `sort` string (default "volume24h", one of "yield7d", "yield30d", "rewardsUsd", "volume24h", "lastPayout", "holders", "priceChange24h")
- `limit` integer (default 25, range 1–100)
- `format` string (default "json", one of "json", "llm", "both")

### stonk-reward-risk — $0.005 USDC

POST https://api.solenrich.com/entrypoints/stonk-reward-risk/invoke

Payout status + trading cost for a StonkFun reward coin

Payout status for a StonkFun reward coin — what a holder observes: PAYING (payout in the last 24h), STALE, NEVER, or NOT_REWARD — plus trading cost (tax bps, round-trip %) and a 0-100 health score read from the chain: fee bps and cap, withdraw authority (must be StonkFun's distributor), fee mutability, distributions and recency, flywheel, holders and concentration, quote category, age. Call before sizing a reward-coin position.

Inputs:
- `mint` string (required) — StonkFun coin mint (base58)
- `format` string (default "json", one of "json", "llm", "both")

### stonk-yield — $0.005 USDC

POST https://api.solenrich.com/entrypoints/stonk-yield/invoke

Trailing 7d/30d holder yield for a StonkFun reward coin

Trailing 7d, 30d, and lifetime holder yield: rewards distributed in the quote asset, priced in USD, divided by average market cap over the window (daily snapshots). Annualized with an explicit caution flag when the window is under 7 days or partial. Returns quote_exposure — what a holder is economically long (the coin + the quote asset) and the reward asset.

Inputs:
- `mint` string (required) — StonkFun reward coin mint (base58)
- `format` string (default "json", one of "json", "llm", "both")

### stonk-quote — $0.005 USDC

POST https://api.solenrich.com/entrypoints/stonk-quote/invoke

Cost and payback of one StonkFun trade at one size

Cost and payback of one StonkFun trade at one size, no swap: entry and exit cost (transfer tax + price impact at size), round-trip % and the breakeven price move, your pro-rata share of each payout with a dust warning, expected payout over the hold from the yield window with real history, and a PAYS / MARGINAL / COSTS / NOT_PAYING verdict with breakeven hold days. Composes stonk-reward-risk, stonk-yield, and enrich-token-light. Inputs: mint, size_usd (100), hold_days (7).

Inputs:
- `mint` string (required) — StonkFun reward coin mint (base58)
- `size_usd` number (default 100, range 1–1000000) — Position size in USD
- `hold_days` number (default 7, range 0.25–365) — Intended holding period
- `format` string (default "json", one of "json", "llm", "both")

### stonk-launch-intel — $0.02 USDC

POST https://api.solenrich.com/entrypoints/stonk-launch-intel/invoke

What to launch on StonkFun and against which quote asset

What to launch on StonkFun, and against what. Per quote asset: coins, launches (24h / 7d), share trading today, share paying holders today, survival past day 3, volume, median holders and mcap, 100 vs 300 bps tax mix with trading and paying rates, crowding, and a 0-100 demand score. Plus overall stats and plain recommendations. Sort by demand, survival, volume, launches, or paying. Milliseconds.

Inputs:
- `category` string (one of "xstock", "prestock", "currency", "leverage", "solana", "collectible", "custom")
- `min_coins` integer (default 5, range 1–…) — Only quotes with at least this many reward coins
- `sort` string (default "demand", one of "demand", "survival", "volume", "launches", "paying")
- `limit` integer (default 20, range 1–100)
- `format` string (default "json", one of "json", "llm", "both")

### stonk-launch-preflight — $0.25 USDC

POST https://api.solenrich.com/entrypoints/stonk-launch-preflight/invoke

Preflight a self-built LaunchLab launch against StonkFun's shape

Decodes the Raydium LaunchLab initialize in your unsigned transaction and diffs it against StonkFun's /launchlab/pricing for that quote + mode: GlobalConfig, platform id, curve, supply, totalSellA, raise, 6-decimal Token-2022 base mint, quote token program, curve-rule account last, and the reward-mode transfer fee (catches the transferFeeBasePoints / maxinumFee spelling). Returns ok, mismatches with fixes, warnings. A mismatched pool is never adopted.

Inputs:
- `unsigned_transaction` string (required) — Base64 unsigned transaction (legacy or v0) carrying the LaunchLab initialize
- `quote_mint` string (required)
- `mode` string (required, one of "standard", "reward")
- `launch_params` object — Optional: the params object passed to the SDK — linted for misspelled transfer-fee field names
- `format` string (default "json", one of "json", "llm", "both")

## Trenches (fresh-launch trade lifecycle)

Memecoins minutes to hours old: what is running, who is buying, should I enter this one, should I exit the one I hold.

### runner-scan — $0.04 USDC

POST https://api.solenrich.com/entrypoints/runner-scan/invoke

Detect Solana memecoins running on-chain right now

Finds fresh Solana memecoins whose on-chain buying is accelerating — the signature of a run in progress, not the lagging fact that price already moved. Measures buy-rate acceleration (5m vs 1h, 1h vs 6h), buy pressure, volume acceleration, price velocity, holder growth and liquidity trend. Classifies RUNNING / IGNITING / PARABOLIC_LATE / FADING with a 0-1 score plus reasoning. Flags wash-trade smell and liquidity pulls rather than dressing them up as momentum.

Inputs:
- `max_token_age_hours` number (default 24, range 0.1–168) — Max token age in hours since first pair (fresh but past block-0)
- `min_liquidity_usd` number (default 10000, range 0–10000000) — Minimum aggregate pool liquidity in USD — filters dust
- `min_volume_h1_usd` number (default 5000, range 0–10000000) — Minimum 1h volume in USD to count as active
- `limit` integer (default 15, range 1–25) — Max tokens to return
- `format` string (default "json", one of "json", "llm", "both")

### smart-money-trenches — $0.05 USDC

POST https://api.solenrich.com/entrypoints/smart-money-trenches/invoke

Reveal proven-winner wallets buying fresh memecoin launches

Which proven-winner wallets are aping fresh (<6h) memecoin launches right now, and what are they buying? Vetted seed set of realized-PnL winners + conviction holders (bot-filtered, live cadence re-checked every scan). Recent buys overlaid against token launch times, ranked by distinct smart buyers + recency. Pre-ape attention signal — pair with due-diligence.

Inputs:
- `hours_back` integer (default 12, range 1–48) — How far back to scan seed-wallet buys (hours)
- `max_token_age_hours` number (default 6, range 1–72) — Max token age (hours since first pair) to count as fresh
- `min_buyers` integer (default 1, range 1–14) — Min distinct smart buyers per token to surface it
- `limit` integer (default 10, range 1–25) — Max tokens to return
- `format` string (default "json", one of "json", "llm", "both")

### trenches-check — $0.03 USDC

POST https://api.solenrich.com/entrypoints/trenches-check/invoke

Vet one token with the three trenches signals

The trenches suite pointed at ONE token: pass a mint, get a HIGH_CONFLUENCE / MODERATE / SINGLE_SIGNAL / NO_SIGNAL verdict with reasoning. Runs on-chain velocity (runner stage + 0-1 score), proven-winner wallet buys (vetted realized-PnL seed set), and agent attention (proprietary query stream) against your candidate. The follow-up call to a new-tokens discovery or any shilled token. Repeat checks 5+ min apart unlock liquidity/holder deltas. NFA.

Inputs:
- `mint` string (required) — Token mint address to check
- `format` string (default "json", one of "json", "llm", "both")

### trenches-scan — $0.08 USDC

POST https://api.solenrich.com/entrypoints/trenches-scan/invoke

Run the three-signal memecoin confluence scan

One call composes runner-scan (on-chain velocity), smart-money-trenches (proven-winner wallet buys), and attention-momentum (agent query stream) into a ranked memecoin list. Per token: composite score (runner 0.45 / smart-money 0.45 / attention 0.10), confluence count, reasoning, and a HIGH_CONFLUENCE / MODERATE / SINGLE_SIGNAL verdict. Legs degrade independently — an upstream failure annotates the result instead of failing the call. NFA.

Inputs:
- `max_token_age_hours` number (default 24, range 1–72) — Max token age in hours
- `min_liquidity_usd` number (default 5000, range 0–10000000) — Liquidity floor in USD (unknown liquidity passes)
- `limit` integer (default 10, range 1–20) — Max picks returned
- `format` string (default "json", one of "json", "llm", "both")

### exit-signal — $0.04 USDC

POST https://api.solenrich.com/entrypoints/exit-signal/invoke

Get an exit verdict for a token you hold

The sell-side verdict: pass a mint you hold, get EXIT / DERISK / HOLD with a 0-1 exit score and reasoning. Reads sell pressure, buy-rate deceleration, volume fade, distribution-into-strength divergence, top-holder flow (distributing vs accumulating whales), liquidity trend, and holder churn. Rug triggers (LP pull, active dump) force EXIT over everything. Works on tokens of any age. Repeat calls 5+ min apart unlock liquidity/holder deltas. NFA.

Inputs:
- `mint` string (required) — Token mint address you hold
- `entry_price_usd` number — Optional entry price in USD — adds unrealized-PnL context, does not change the verdict
- `format` string (default "json", one of "json", "llm", "both")

### attention-momentum — $0.02 USDC

POST https://api.solenrich.com/entrypoints/attention-momentum/invoke

Rank tokens by agent-attention acceleration with price divergence

Tokens ranked by how fast agent attention is speeding up — query velocity change across three consecutive windows, overlaid with price change over the same window. Divergence classes: early_signal (attention accelerating, price flat), confirmed_momentum, distribution_risk (attention cooling while price pumps), fading. Proprietary: derived from SolEnrich's own agent query stream, not market volume. sample_quality reports signal density honestly.

Inputs:
- `window` string (default "6h", one of "1h", "6h", "24h") — Window size — acceleration compares three consecutive windows of this size
- `limit` integer (default 10, range 1–25) — Max ranked entries returned
- `format` string (default "json", one of "json", "llm", "both")

## Smart money and whales

Proven-winner wallets and large holders: where they move on Solana spot and on Hyperliquid perps.

### smart-money-flow — $0.100 USDC

POST https://api.solenrich.com/entrypoints/smart-money-flow/invoke

Reveal what proven-winner Solana wallets are accumulating

Scores seed wallets via copy-trade metrics (win rate, Sharpe, consistency), filters to qualifying winners, then surfaces tokens they're accumulating and wallet clusters. Pass your own `wallets` array or use the curated default seed list.

Inputs:
- `wallets` string[] (1–30 items) — Optional Solana wallet addresses to score (uses curated default if omitted)
- `lookback_days` number (default 14, range 1–90) — Copy-trade lookback window in days
- `min_win_rate` number (default 0.55, range 0–1) — Minimum win rate to qualify as smart money (0-1)
- `top_n_tokens` number (default 10, range 1–20) — Max tokens to surface as accumulated
- `include_graph` boolean (default true) — Include cluster analysis via wallet-graph (adds latency)
- `format` string (default "json", one of "json", "llm", "both")

### copy-trade-signals — $0.010 USDC

POST https://api.solenrich.com/entrypoints/copy-trade-signals/invoke

Score a Solana wallet trading PnL, win rate, and consistency

Trading PnL, win rate, Sharpe/Sortino ratios, max drawdown, profit factor.

Inputs:
- `address` string (required) — Solana base58 wallet address
- `lookback_days` number (default 30, range 1–90) — Days of trading history
- `format` string (default "json", one of "json", "llm", "both")

### whale-watch — $0.008 USDC

POST https://api.solenrich.com/entrypoints/whale-watch/invoke

Track whale holders and their recent flows for a Solana token

Top holders with accumulation/distribution tracking, balance context, supply percentage.

Inputs:
- `mint` string (required) — Solana token mint address
- `threshold_usd` number (default 10000, range 100–…) — Minimum USD value to qualify as whale
- `lookback_hours` number (default 24, range 1–168) — Hours of history to analyze
- `format` string (default "json", one of "json", "llm", "both")

### hyperliquid-smart-money — $0.05 USDC

POST https://api.solenrich.com/entrypoints/hyperliquid-smart-money/invoke

Read Hyperliquid smart-money positioning consensus per coin

Where Hyperliquid smart money is positioned. Scans the HL leaderboard, excludes market-makers/HFT and dust/mega accounts, keeps consistent directional traders (week+month PnL > 0), then aggregates their live positions into a per-coin consensus (long/short counts, net notional, bias, conviction) plus a top-trader drill-down ranked by month PnL. A positioning signal, not a trade: consensus is often crowded and regime-dependent.

Inputs:
- `market` string — Optional single-coin focus, e.g. HYPE/BTC/ETH
- `top_traders` integer (range 1–25) — How many top traders to include (default 10)
- `format` string (default "json", one of "json", "llm", "both")

### hyperliquid-trader-profile — $0.012 USDC

POST https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke

Profile a Hyperliquid trader: live positions, leverage, PnL

Live perp positions for a Hyperliquid EVM (0x) address, read from Hyperliquid's public on-chain state. Per-position coin, side, leverage, notional, entry, unrealized PnL, distance-to-liquidation, and risk flags (high/extreme leverage, approaching liquidation, losing). Plus account value, directional bias, profile, weighted leverage, and realized+unrealized PnL over week/month/all-time. The building block for smart-money tracking.

Inputs:
- `address` string (required) — Hyperliquid EVM (0x) address
- `format` string (default "json", one of "json", "llm", "both")

## Perps (Jupiter, Adrena, Flash, Hyperliquid, dYdX)

Cross-venue funding, open interest, entry cost at size, basis, and trader positioning.

### perps-venue-comparison — $0.020 USDC

POST https://api.solenrich.com/entrypoints/perps-venue-comparison/invoke

Compare perps venues by total entry cost at a trade size

Builds on cross-venue funding with size-aware fields: Jupiter Quote spot slippage at requested size, per-venue fee, OI cap headroom, first-hour borrow cost, and total entry cost. Returns rankings by entry cost / borrow APR / headroom plus a recommendation venue with warnings. Use when sizing a real position; use perps-cross-venue-funding for rates-only context.

Inputs:
- `market` string (required, one of "SOL", "BTC", "ETH", "BONK") — Asset to query
- `size_usd` number (required, range 100–10000000) — Position size in USD
- `side` string (default "long", one of "long", "short") — Side being sized
- `format` string (default "json", one of "json", "llm", "both")

### perps-cross-venue-funding — $0.015 USDC

POST https://api.solenrich.com/entrypoints/perps-cross-venue-funding/invoke

Compare perps funding and open interest across five venues

Aggregates borrow/funding APR + open interest across Solana on-chain venues (Jupiter Perps, Adrena) and cross-chain reference venues (Hyperliquid, dYdX v4). Returns per-venue quotes, best entry per side, basis vs Hyperliquid, and arbitrage opportunities. Adrena uses wrapped collateral (SOL via jitoSOL, BTC via WBTC); ETH unsupported there, BONK not on Jupiter Perps. New venues fold in additively as they launch.

Inputs:
- `market` string (required, one of "SOL", "BTC", "ETH", "BONK") — Asset to query
- `include_reference` boolean (default true) — Include Hyperliquid + dYdX v4 reference rates
- `format` string (default "json", one of "json", "llm", "both")

### perps-market-structure — $0.012 USDC

POST https://api.solenrich.com/entrypoints/perps-market-structure/invoke

Read Jupiter Perps market structure: OI, borrow APR, health

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

Inputs:
- `format` string (default "json", one of "json", "llm", "both")

### perps-basis-signal — $0.015 USDC

POST https://api.solenrich.com/entrypoints/perps-basis-signal/invoke

Scan perp-vs-spot basis trades for net yield after borrow

Computes perp mark vs spot price across venues and surfaces actually-earnable yield (funding APR on Hyperliquid + dYdX, not viable on pool perps Jupiter + Adrena). Returns per-venue trade economics, opportunities above threshold, and best trade. Threshold defaults to 5% APR.

Inputs:
- `asset` string (required, one of "SOL", "BTC", "ETH", "BONK") — Asset to scan
- `min_yield_apr_pct` number (default 5, range 0–100) — Minimum net yield (APR %) for an opportunity to be surfaced
- `format` string (default "json", one of "json", "llm", "both")

### perps-market-trend — $0.008 USDC

POST https://api.solenrich.com/entrypoints/perps-market-trend/invoke

Track Jupiter Perps market trends for SOL, BTC, and ETH

Per-symbol deltas for mark price, total OI, long/short skew, utilization, and borrow APR over 7/14/30 days. Direction indicators per metric and per market. Overall direction excludes mark price (price moves are not health signals). Required for regime-detection strategies and any bot that adjusts behavior based on whether markets are growing, stressed, or rebalancing. Mirror of token-trend for perps.

Inputs:
- `lookback` string (default "7d", one of "7d", "14d", "30d") — History window to compare current state against
- `format` string (default "json", one of "json", "llm", "both")

### perps-trader-profile — $0.010 USDC

POST https://api.solenrich.com/entrypoints/perps-trader-profile/invoke

Profile a perps trader across Jupiter Perps and Adrena venues

Open positions across BOTH Jupiter Perps and Adrena for a wallet. Per-position size, leverage, entry, unrealized PnL, position age. Per-venue breakdown via `by_venue`, combined totals at top level, every position tagged with `venue`. Trader classification (scalper/swing/position), directional bias, and risk flags including `multi_venue` for cross-venue exposure. Adrena PnL uses jitoSOL/WBTC/BONK mark prices from Jupiter price API; null when unavailable.

Inputs:
- `address` string (required) — Solana wallet address
- `format` string (default "json", one of "json", "llm", "both")

## Core wallet, token, and transaction intelligence

The primitives every other suite composes: token safety and slippage, wallet risk and bot flags, parsed transactions.

### due-diligence — $0.020 USDC

POST https://api.solenrich.com/entrypoints/due-diligence/invoke

Run full due diligence on a Solana token with a risk verdict

Composite risk: token analysis + whale activity + holder concentration. Returns SAFE/CAUTION/RISKY verdict.

Inputs:
- `mint` string (required) — Solana token mint address
- `format` string (default "json", one of "json", "llm", "both")

### enrich-token-light — $0.002 USDC

POST https://api.solenrich.com/entrypoints/enrich-token-light/invoke

Analyze a Solana token: price, liquidity, and risk flags

Price (median of 3 sources), market cap, volume, liquidity, slippage estimates at 4 position sizes, risk flags, verification status.

Inputs:
- `mint` string (required) — Solana token mint address
- `format` string (default "json", one of "json", "llm", "both")

### enrich-token-full — $0.004 USDC

POST https://api.solenrich.com/entrypoints/enrich-token-full/invoke

Analyze a Solana token in depth: holders, concentration, risk

Adds top 20 holders, HHI concentration index, volatility metrics, slippage estimates to light token analysis.

Inputs:
- `mint` string (required) — Solana token mint address
- `include_holders` boolean (default true) — Include top 20 holder breakdown
- `format` string (default "json", one of "json", "llm", "both")

### enrich-wallet-light — $0.002 USDC

POST https://api.solenrich.com/entrypoints/enrich-wallet-light/invoke

Profile a Solana wallet: holdings, labels, and risk score

SOL balance, token holdings, NFT breakdown (collected vs compressed airdrops vs suspected spam, with a per-collection list), labels (including behavioral flags: regular_intervals, high_frequency, 24_7_active, repetitive_actions — algorithmic signals from tx timing that indicate automated activity), risk score. Fast and cheap.

Inputs:
- `address` string (required) — Solana base58 wallet address
- `format` string (default "json", one of "json", "llm", "both")

### enrich-wallet-full — $0.005 USDC

POST https://api.solenrich.com/entrypoints/enrich-wallet-full/invoke

Profile a Solana wallet in depth: DeFi positions, connections, risk

Adds DeFi positions, connected wallets, enhanced transaction history, automated-activity behavioral signals, and a wider NFT collection breakdown to the light profile.

Inputs:
- `address` string (required) — Solana base58 wallet address
- `depth` string (default "full", one of "light", "full")
- `format` string (default "json", one of "json", "llm", "both")

### parse-transaction — $0.001 USDC

POST https://api.solenrich.com/entrypoints/parse-transaction/invoke

Parse a Solana transaction into a readable action summary

Type detection, protocol identification, transfer breakdown, account roles.

Inputs:
- `signature` string (required) — Solana transaction signature (base58)
- `format` string (default "json", one of "json", "llm", "both")

## Discovery, signals, and alerts

What is worth attention right now, what other agents are querying, and event alerts against a watchlist.

### query — $0.003 USDC

POST https://api.solenrich.com/entrypoints/query/invoke

Answer a natural-language question about Solana onchain data

Plain English questions routed to the right enricher(s). Single-intent ("is X safe?") hits one enricher; compound intents chain 2-3 in parallel: "should I buy X?" → DD + trend + whales; "wallet deep dive" → profile + history + perps; "what's trending?" → trending-signals; "SOL-PERP funding rate" → perps-market.

Inputs:
- `question` string (required) — Natural language question about a Solana wallet or token
- `format` string (default "json", one of "json", "llm", "both")

### trending-signals — $0.050 USDC

POST https://api.solenrich.com/entrypoints/trending-signals/invoke

Rank trending Solana tokens with composite buy-side signals

Composes token-discovery + whale-watch + risk scoring across DexScreener trending. Returns a composite-signal ranked list (liquidity, risk, concentration, whale flow) with per-token reasoning and overall sentiment (accumulation/distribution/mixed). "What's worth paying attention to right now?"

Inputs:
- `min_liquidity_usd` number (default 10000) — Minimum liquidity in USD for candidates
- `max_risk_score` number (default 0.7, range 0–1) — Maximum token risk score (0-1)
- `limit` number (default 10, range 1–20) — Number of tokens to return
- `include_whale_watch` boolean (default true) — Layer whale-watch flow signal per token (slower but higher signal)
- `format` string (default "json", one of "json", "llm", "both")

### new-tokens — $0.012 USDC

POST https://api.solenrich.com/entrypoints/new-tokens/invoke

Discover newly launched Solana tokens ranked by safety

Recently launched tokens from DexScreener, filtered by liquidity and risk, ranked safest first.

Inputs:
- `min_liquidity_usd` number (default 1000) — Minimum liquidity in USD
- `max_risk_score` number (default 0.8, range 0–1) — Maximum risk score (0-1)
- `limit` number (default 10, range 1–20) — Number of tokens to return
- `format` string (default "json", one of "json", "llm", "both")

### consensus-signal — $0.005 USDC

POST https://api.solenrich.com/entrypoints/consensus-signal/invoke

Reveal which tokens or wallets agents are querying right now

What tokens or wallets are being queried by other agents right now. Derived from SolEnrich's own query stream — not market volume. Two modes: pass `address` for that entity's rank/percentile/trend; omit it for the top-N most-queried entities in the window. Windows: 1h, 6h, 24h. Unique data — only available because we serve agents directly.

Inputs:
- `type` string (default "token", one of "token", "wallet")
- `address` string — Optional Solana address — single-entity report when provided
- `window` string (default "1h", one of "1h", "6h", "24h")
- `limit` integer (default 10, range 1–50) — Top-N size when address is omitted
- `format` string (default "json", one of "json", "llm", "both")

### feed-latest — $0.005 USDC

POST https://api.solenrich.com/entrypoints/feed-latest/invoke

Fetch the daily SolEnrich Solana intelligence brief

Pre-computed ranking of trending Solana tokens with composite-signal scoring. Cached 24h, lazy-populated on cache miss. Designed for recurring polling at lower per-call cost than direct orchestration. Pass `since` (ISO 8601) to short-circuit on no-change polls.

Inputs:
- `since` string — Optional ISO 8601 timestamp of last successful poll. If brief is not newer, response sets unchanged=true with empty payload.
- `format` string (default "json", one of "json", "llm", "both")

### check-alerts — $0.008 USDC

POST https://api.solenrich.com/entrypoints/check-alerts/invoke

Check spot and perps event alerts for tokens and wallets

Poll-based event detection for spot + Jupiter Perps. Pass a watchlist (<=10 tokens, <=10 wallets) and a `since` ISO 8601 timestamp; get alerts fired since then. Token alerts: price spikes/drops, whale inflow/outflow, concentration shifts. Wallet alerts: risk changes, portfolio value moves, position add/remove. Perps alerts per wallet: position add/close, at-risk, liquidation-approaching, pnl-swing. Stateless; the agent owns the `since` cursor.

Inputs:
- `tokens` string[] (1–10 items) — Token mints to monitor
- `wallets` string[] (1–10 items) — Wallet addresses to monitor (spot + Jupiter Perps)
- `since` string (required) — ISO 8601 timestamp — return alerts fired since this moment
- `criteria` object — Optional alert thresholds
- `format` string (default "json", one of "json", "llm", "both")

### protocol-profile — $0.008 USDC

POST https://api.solenrich.com/entrypoints/protocol-profile/invoke

Profile a Solana DeFi protocol: TVL, yields, onchain activity

Protocol TVL, yield pools, on-chain activity metrics, health signals, and automated_activity_pct (% of top signers with regular-interval or high-frequency tx patterns — surfaces agent-driven protocol usage). Supports Raydium, Orca, marginfi, Drift, Jupiter, Kamino, Marinade, Jito, and more.

Inputs:
- `protocol` string (required) — Protocol slug (e.g. "raydium", "orca") or Solana program ID
- `include_yields` boolean (default true) — Include yield pool data
- `format` string (default "json", one of "json", "llm", "both")

## Temporal (what changed)

Daily snapshots with direction per metric.

### token-trend — $0.006 USDC

POST https://api.solenrich.com/entrypoints/token-trend/invoke

Track how a Solana token metrics changed over 7-30 days

Daily snapshots with direction indicators (improving/declining/stable) per metric.

Inputs:
- `mint` string (required) — Solana token mint address
- `lookback` string (default "7d", one of "7d", "14d", "30d")
- `format` string (default "json", one of "json", "llm", "both")

### wallet-history — $0.006 USDC

POST https://api.solenrich.com/entrypoints/wallet-history/invoke

Track how a Solana wallet changed over 7-30 days

Portfolio snapshots with position changes (added/removed holdings), direction indicators.

Inputs:
- `address` string (required) — Solana base58 wallet address
- `lookback` string (default "7d", one of "7d", "14d", "30d")
- `format` string (default "json", one of "json", "llm", "both")

### portfolio-history — $0.006 USDC

POST https://api.solenrich.com/entrypoints/portfolio-history/invoke

Chart a Solana wallet portfolio value as a daily time series

Daily portfolio snapshots (value, SOL balance, token count, risk score) for a wallet over 7/14/30 days, plus summary stats: peak, trough, max drawdown, average value, change vs period start. Designed for charting and PnL tracking; complements wallet-history which returns two-point deltas. Today's live point is appended automatically.

Inputs:
- `address` string (required) — Solana base58 wallet address
- `period` string (default "7d", one of "7d", "14d", "30d")
- `format` string (default "json", one of "json", "llm", "both")

## Batch, comparison, and graph

Many addresses in one call, side-by-side rankings, wallet connection maps.

### batch-enrich — $0.015 USDC

POST https://api.solenrich.com/entrypoints/batch-enrich/invoke

Enrich multiple Solana wallets or tokens in one batched call

Parallel enrichment of 1-25 wallets or tokens in a single call.

Inputs:
- `addresses` string[] (required, 1–25 items) — Solana addresses to enrich
- `type` string (required, one of "wallet", "token") — Address type
- `depth` string (default "light", one of "light", "full")
- `format` string (default "json", one of "json", "llm", "both")

### compare-tokens — $0.006 USDC

POST https://api.solenrich.com/entrypoints/compare-tokens/invoke

Compare Solana tokens side by side with per-metric rankings

Compare 2-3 tokens: price, liquidity, volatility, HHI, risk. Rankings + summary picks.

Inputs:
- `mints` string[] (required, 2–3 items) — Token mint addresses to compare
- `format` string (default "json", one of "json", "llm", "both")

### compare-wallets — $0.006 USDC

POST https://api.solenrich.com/entrypoints/compare-wallets/invoke

Compare Solana wallets side by side with per-metric rankings

Compare 2-3 wallets: portfolio, activity, risk, labels. Rankings + summary picks.

Inputs:
- `addresses` string[] (required, 2–3 items) — Wallet addresses to compare
- `depth` string (default "light", one of "light", "full")
- `format` string (default "json", one of "json", "llm", "both")

### wallet-graph — $0.010 USDC

POST https://api.solenrich.com/entrypoints/wallet-graph/invoke

Map a Solana wallet connection graph and detect clusters

Transaction connection mapping, suspicious cluster detection, depth-1 or depth-2 hops.

Inputs:
- `address` string (required) — Solana base58 wallet address
- `depth` number (default 1, range 1–2) — Hop depth (1 or 2)
- `min_interactions` number (default 1, range 1–…) — Minimum interactions to include connection
- `format` string (default "json", one of "json", "llm", "both")

## Collectibles

Jupiter Gacha pack expected value.

### gacha-ev-scan — $0.02 USDC

POST https://api.solenrich.com/entrypoints/gacha-ev-scan/invoke

Scan Jupiter Gacha packs for net-of-exit expected value

Jupiter Gacha (Collector Crypt) tokenized-card pack EV scan. For each pack machine, computes net-of-exit-mechanics EV: gross insured EV vs the guaranteed instant-buyback floor (85-93%% of insured, <=72h) vs a marketplace sale (insured value minus 2%% fee, fill-risk). Returns a POSITIVE_EV / HOUSE_EDGE / NEGATIVE_EV verdict per machine plus rare+epic stock share, ranked by the chosen exit path. All inputs optional.

Inputs:
- `machine` string — Restrict to one machine code (e.g. pokemon_50). Omit to scan all.
- `franchise` string (default "all", one of "pokemon", "onepiece", "all") — Franchise filter
- `exit_strategy` string (default "both", one of "buyback", "marketplace", "both") — Which exit path to rank/verdict against
- `min_edge_pct` number (range -100–100) — Only surface machines whose net edge (per exit_strategy) >= this percentage
- `format` string (default "json", one of "json", "llm", "both")

## Scoring methodology

- **risk_score**
  - **description**: Wallet risk score from 0.0 (safe) to 1.0 (critical). Pure on-chain, deterministic.
  - **factors**
    - High transaction concentration (few counterparties) — +0.15
    - Low transaction diversity — +0.1
    - New wallet (< 30 days old) — +0.15
    - Bot-like patterns (high frequency, repetitive) — +0.2
    - Interactions with known risky programs — +0.15
    - Airdrop farming signals (many small token accounts) — +0.1
    - Low protocol diversity (< 2 protocols) — +0.1
  - **levels**
    - **LOW**: < 0.25
    - **MODERATE**: 0.25 - 0.50
    - **ELEVATED**: 0.50 - 0.65
    - **HIGH**: 0.65 - 0.80
    - **CRITICAL**: > 0.80
- **token_risk_score**
  - **description**: Token risk score from 0.0 to 1.0 used in due-diligence. Combines risk flags, holder concentration, and whale activity.
  - **factors**
    - Risk flags count — each adds 0.1
    - Not verified on Jupiter — +0.1
    - Mint authority still active — +0.15
    - Freeze authority active — +0.1
    - Top holder > 50% supply — +0.15
    - Top 5 holders > 80% supply — +0.1
    - Whale distribution activity detected — +0.05
  - **verdicts**
    - **SAFE**: risk_score < 0.3
    - **CAUTION**: risk_score 0.3 - 0.6
    - **RISKY**: risk_score > 0.6
- **hhi**
  - **description**: Herfindahl-Hirschman Index — sum of squared holder percentages. Measures concentration shape. Based on top 20 holders from Solana RPC.
  - **interpretation**
    - **< 1500**: Well distributed
    - **1500 - 2500**: Moderately concentrated
    - **> 2500**: Highly concentrated
- **volatility**
  - **description**: Price volatility computed from DexScreener multi-timeframe data (1h, 6h, 24h price changes). No extra API calls.
  - **classifications**
    - **LOW**: daily std < 3%
    - **MODERATE**: daily std 3-8%
    - **HIGH**: daily std 8-15%
    - **EXTREME**: daily std > 15%
- **pricing**
  - **description**: Token prices are the median of up to 3 sources: Helius DAS, DexScreener, and Jupiter. Median resists outliers from any single DEX.

## Data sources

- **helius**: DAS API for wallet assets, enhanced transaction parsing. Primary source.
- **dexscreener**: Token prices, market data, liquidity, OHLCV. Free API.
- **jupiter**: Token metadata, verification status, cross-reference pricing. Free API.
- **defi_llama**: Protocol TVL and yield data. Free API.
- **solana_rpc**: SOL balances, mint info, top holders (via Helius RPC endpoint).

## Links

- Site: https://www.solenrich.com
- Short index: https://api.solenrich.com/llms.txt
- OpenAPI: https://api.solenrich.com/openapi.json
- x402 discovery: https://api.solenrich.com/.well-known/x402
- MCP: https://api.solenrich.com/mcp
- Live status: https://api.solenrich.com/status
- Provider: @0xSardius (https://x.com/0xSardius)