# Ventis

> Crypto market data for AI agents, served over MCP (Streamable HTTP) and paid per request in USDC on Solana via x402.

## Endpoints
- Free MCP: https://ventis-production.up.railway.app/mcp (tools: get_price, list_tools_pro; 30 requests per minute)
- Pro MCP: https://ventis-production.up.railway.app/mcp/pro (0.004 USDC per tool call, Solana, x402 v1 "exact" scheme)
- Premium MCP: https://ventis-production.up.railway.app/mcp/premium (0.006 USDC per tool call: all Pro tools plus wallet_portfolio, token_risk, solana_token, funding_rates, new_tokens; market_brief is 0.01 USDC)
- x402 discovery: https://ventis-production.up.railway.app/.well-known/x402
- Health: https://ventis-production.up.railway.app/health

## Pro tools
- market_overview(limit): top coins by market cap with price, volume, 24h and 7d change
- trending(): currently trending coins
- ohlc(id, days): OHLC candles (days: 1, 7, 14, 30, 90, 180, 365)
- coin_profile(id): supply, all-time high, categories, homepage
- global_stats(): total market cap, volume, dominance
- fear_greed(days): Crypto Fear & Greed Index history
- swap_quote(from, to, amount, slippage_bps): best-route Solana swap quote via Jupiter (out amount, minimum received, price impact, route). Quote only

## Premium tools (plus all Pro tools)
- wallet_portfolio(wallet, min_usd): every token in a Solana wallet with USD value and share, sorted by value (Jupiter)
- token_risk(token): Solana token safety check: mint/freeze authority, top-holder share, liquidity, age, verification; scored low/medium/high
- market_brief(): one call returns global stats, Fear & Greed, top gainers/losers, trending and BTC/ETH/SOL funding (0.01 USDC)
- solana_token(query): Solana token price, liquidity, volume, top DEX pairs by mint address or symbol (DexScreener)
- funding_rates(symbols): perpetual futures funding rates and annualised rate (OKX)
- new_tokens(chain, limit): newest token profiles (DexScreener)

## How to pay
POST a JSON-RPC MCP request to /mcp/pro. The server replies HTTP 402 with payment requirements.
Sign a USDC transfer (fee paid by the PayAI facilitator) and retry with the X-PAYMENT header.
Any x402 client works, for example x402-fetch with createSigner("solana", key).
All tools return structuredContent (typed JSON). Prompts: daily_brief, swap_check (Pro), token_due_diligence and portfolio_review (Premium).
Data sources: Jupiter, CoinGecko (Coinpaprika backup for spot prices), alternative.me, DexScreener, OKX.