WealthVille

Build with Wealthville data

Pool scores, verdicts, and an outcome-labeled signal feed for Solana and EVM liquidity pools — public, free, CORS-open, and documented with an OpenAPI spec.

Quick start

No key required. Try it from your terminal:

# Top pools by Wealthville Score (0-100)
curl https://wealthville.net/api/v1/scores/top?limit=10

# One pool's Enter/Hold/Exit scores + verdict
curl https://wealthville.net/api/v1/scores/{poolAddress}

# Live track record — hit rates and IL-adjusted PnL, misses included
curl https://wealthville.net/api/v1/track-record?days=30

Endpoints

  • GET /api/v1/scores/top — freshly scored pools ranked by composite score. ?chain=solana|evm|ethereum|base|…
  • GET /api/v1/scores/{poolAddress} — one pool's verdict, confidence, and the four action scores.
  • GET /api/v1/track-record — per-action hit rates, IL-adjusted 7-day PnL, and the 50 most recent resolved signals.
  • GET /api/v1/signals/feed — the published-signal feed with narratives and branded images.
  • GET /api/v1/openapi.json — the full machine-readable contract.

AI agents (MCP & agent frameworks)

Building with AI agents? We ship ready-made connectors so your agent can check a pool's score before touching it:

  • MCP server — tools like get_pool_score and get_track_record for Claude, Cursor, and any MCP client.
  • Solana Agent Kit pluginWEALTHVILLE_GET_POOL_SCORE actions for on-chain agents.
  • ElizaOS plugin — pool-score answers for conversational DeFi agents.

All read-only — no wallet access, nothing to sign. Contact us for the connector packages while we finish publishing them to the public registries.

Rate limits & partner keys

Anonymous access is open at 60 requests/min per IP — enough for most apps with the built-in response caching. Building something bigger (a wallet, bot, tracker, or aggregator)? Partner keys raise the limit and identify your integration — send yours as the x-api-key header. Reach out via the contact on our site to get one; keys are free.

Why trust the scores

Every published signal is frozen at publish time and labeled after the fact against realized yield and impermanent loss — misses included, live at the track record. The scoring rules are validated on ~3 years of daily history across 1,600+ pools with strict walk-forward splits, and the same engine allocates Wealthville's own on-chain vault capital. Read the methodology.

Fair use

The data is free for both commercial and non-commercial use with attribution — link to wealthville.net where scores are displayed. The API serves cached reads (5–10 min); hammering it past the limits gets an HTTP 429, not a ban. This is a data product, not financial advice.

Latest insights

Research, Recaps & Solana Alpha

Data-driven yield analysis and weekly market wraps — written for active LPs.

All insights