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. One-line install: see wealthville.net/mcp. - 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. Grab them at github.com/amitesh-m/wealthville-integrations.
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.
There is no paid API tier and no billing. Full fee breakdown, including what the vaults charge, is on the pricing page.
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.
