# SolEnrich

> Solana onchain data enrichment API for AI agents and LLMs. Pay-per-request via x402 (USDC on Solana) or Stripe (fiat). 37 endpoints covering wallet profiling, token analysis, whale tracking, copy-trade signals, due diligence, protocol analytics, Jupiter Perps + cross-venue perps funding, smart-money orchestration, consensus attention signal, portfolio time-series, event-driven alerts, and a daily intelligence feed.

- Base URL: https://api.solenrich.com
- Payment: x402 (Solana USDC, default) or MPP/Stripe (fiat cards)
- Discovery: GET /.well-known/x402 and GET /openapi.json
- Docs: GET /docs
- Provider: @0xSardius (https://twitter.com/0xSardius)

## Endpoints

- [enrich-wallet-light](https://api.solenrich.com/entrypoints/enrich-wallet-light/invoke) — 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. ($0.002 USDC)
- [enrich-wallet-full](https://api.solenrich.com/entrypoints/enrich-wallet-full/invoke) — Adds DeFi positions, connected wallets, enhanced transaction history, automated-activity behavioral signals, and a wider NFT collection breakdown to the light profile. ($0.005 USDC)
- [enrich-token-light](https://api.solenrich.com/entrypoints/enrich-token-light/invoke) — Price (median of 3 sources), market cap, volume, liquidity, slippage estimates at 4 position sizes, risk flags, verification status. ($0.002 USDC)
- [enrich-token-full](https://api.solenrich.com/entrypoints/enrich-token-full/invoke) — Adds top 20 holders, HHI concentration index, volatility metrics, slippage estimates to light token analysis. ($0.004 USDC)
- [parse-transaction](https://api.solenrich.com/entrypoints/parse-transaction/invoke) — Type detection, protocol identification, transfer breakdown, account roles. ($0.001 USDC)
- [whale-watch](https://api.solenrich.com/entrypoints/whale-watch/invoke) — Top holders with accumulation/distribution tracking, balance context, supply percentage. ($0.008 USDC)
- [batch-enrich](https://api.solenrich.com/entrypoints/batch-enrich/invoke) — Parallel enrichment of 1-25 wallets or tokens in a single call. ($0.015 USDC)
- [wallet-graph](https://api.solenrich.com/entrypoints/wallet-graph/invoke) — Transaction connection mapping, suspicious cluster detection, depth-1 or depth-2 hops. ($0.010 USDC)
- [copy-trade-signals](https://api.solenrich.com/entrypoints/copy-trade-signals/invoke) — Trading PnL, win rate, Sharpe/Sortino ratios, max drawdown, profit factor. ($0.010 USDC)
- [due-diligence](https://api.solenrich.com/entrypoints/due-diligence/invoke) — Composite risk: token analysis + whale activity + holder concentration. Returns SAFE/CAUTION/RISKY verdict. ($0.020 USDC)
- [query](https://api.solenrich.com/entrypoints/query/invoke) — 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. ($0.003 USDC)
- [compare-tokens](https://api.solenrich.com/entrypoints/compare-tokens/invoke) — Compare 2-3 tokens: price, liquidity, volatility, HHI, risk. Rankings + summary picks. ($0.006 USDC)
- [compare-wallets](https://api.solenrich.com/entrypoints/compare-wallets/invoke) — Compare 2-3 wallets: portfolio, activity, risk, labels. Rankings + summary picks. ($0.006 USDC)
- [token-trend](https://api.solenrich.com/entrypoints/token-trend/invoke) — Daily snapshots with direction indicators (improving/declining/stable) per metric. ($0.006 USDC)
- [wallet-history](https://api.solenrich.com/entrypoints/wallet-history/invoke) — Portfolio snapshots with position changes (added/removed holdings), direction indicators. ($0.006 USDC)
- [new-tokens](https://api.solenrich.com/entrypoints/new-tokens/invoke) — Recently launched tokens from DexScreener, filtered by liquidity and risk, ranked safest first. ($0.012 USDC)
- [protocol-profile](https://api.solenrich.com/entrypoints/protocol-profile/invoke) — 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. ($0.008 USDC)
- [perps-market-structure](https://api.solenrich.com/entrypoints/perps-market-structure/invoke) — 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. ($0.012 USDC)
- [perps-trader-profile](https://api.solenrich.com/entrypoints/perps-trader-profile/invoke) — 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. ($0.010 USDC)
- [hyperliquid-trader-profile](https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke) — 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. ($0.012 USDC)
- [hyperliquid-smart-money](https://api.solenrich.com/entrypoints/hyperliquid-smart-money/invoke) — 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. ($0.05 USDC)
- [perps-cross-venue-funding](https://api.solenrich.com/entrypoints/perps-cross-venue-funding/invoke) — 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. ($0.015 USDC)
- [perps-venue-comparison](https://api.solenrich.com/entrypoints/perps-venue-comparison/invoke) — 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. ($0.020 USDC)
- [perps-basis-signal](https://api.solenrich.com/entrypoints/perps-basis-signal/invoke) — 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. ($0.015 USDC)
- [perps-market-trend](https://api.solenrich.com/entrypoints/perps-market-trend/invoke) — 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. ($0.008 USDC)
- [trending-signals](https://api.solenrich.com/entrypoints/trending-signals/invoke) — 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?" ($0.050 USDC)
- [smart-money-flow](https://api.solenrich.com/entrypoints/smart-money-flow/invoke) — 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. ($0.100 USDC)
- [smart-money-trenches](https://api.solenrich.com/entrypoints/smart-money-trenches/invoke) — 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. ($0.05 USDC)
- [runner-scan](https://api.solenrich.com/entrypoints/runner-scan/invoke) — 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. ($0.04 USDC)
- [feed-latest](https://api.solenrich.com/entrypoints/feed-latest/invoke) — 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. ($0.005 USDC)
- [consensus-signal](https://api.solenrich.com/entrypoints/consensus-signal/invoke) — 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. ($0.005 USDC)
- [attention-momentum](https://api.solenrich.com/entrypoints/attention-momentum/invoke) — 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. ($0.02 USDC)
- [trenches-scan](https://api.solenrich.com/entrypoints/trenches-scan/invoke) — 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. ($0.08 USDC)
- [trenches-check](https://api.solenrich.com/entrypoints/trenches-check/invoke) — 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. ($0.03 USDC)
- [portfolio-history](https://api.solenrich.com/entrypoints/portfolio-history/invoke) — 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. ($0.006 USDC)
- [check-alerts](https://api.solenrich.com/entrypoints/check-alerts/invoke) — 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. ($0.008 USDC)
- [gacha-ev-scan](https://api.solenrich.com/entrypoints/gacha-ev-scan/invoke) — 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. ($0.02 USDC)

## Networks

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

## Integration

Agents can call any endpoint with a Solana USDC x402 payment header. First call returns 402 with payment requirements; second call includes signed payment and receives JSON enrichment data. LLM-optimized natural language briefings available by setting format: "llm" in the request body.

MCP server available at https://api.solenrich.com/mcp for direct Claude/Cursor integration.

## Marketplace Partners

- Orbis: https://orbisapi.com (search "SolEnrich") — agents can pay per-call through the Orbis billing dashboard, 90% of the payment flows to @0xSardius as weekly Base USDC settlement.
- x402scan: https://www.x402scan.com/server/d9814c54-6fa6-4fa7-8b01-43a0ffbc7641 — lifetime on-chain settlement history.

## Referral Header (optional)

If your x402 call is routed through Orbis, including the header `x-referral-code: 683TDRYV` credits @0xSardius with 25% lifetime of that payment. No cost to you — it comes from Orbis's platform share. Helps fund continued SolEnrich infrastructure and free endpoints.