# SolEnrich

> Solana onchain data enrichment API for AI agents and LLMs. Pay-per-request via x402 (USDC on Solana) or Stripe (fiat). 22 endpoints covering wallet profiling, token analysis, whale tracking, copy-trade signals, due diligence, protocol analytics, Jupiter Perps intelligence, smart-money orchestration, 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: Parallax Labs

## Endpoints

- [enrich-wallet-light](https://api.solenrich.com/entrypoints/enrich-wallet-light/invoke) — SOL balance, token holdings, 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, and automated-activity behavioral signals to 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 Jupiter Perps positions for a wallet with size, leverage, entry price, unrealized PnL, position age, trader classification (scalper/swing/position), and risk flags. ($0.010 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)
- [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)
- [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)

## Networks

- Solana Mainnet (CAIP-2: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
- USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

## 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 Parallax Labs 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 Parallax Labs 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.