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=30Endpoints
- 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_scoreandget_track_recordfor Claude, Cursor, and any MCP client. - Solana Agent Kit plugin —
WEALTHVILLE_GET_POOL_SCOREactions 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.




