Most users analyze wallets straight from our Telegram bot — no setup needed. These docs are for developers who want to integrate Polyvision into their own tools via REST API, MCP server, or AI agent skills. New users get a 7-day free trial with full access — no credit card required.
Listed on ClawHubGet a free API key from our Telegram bot, then start your 7-day trial. Two steps. That's it.
Open @PolyVisionBot on Telegram and type the command below into the chat: /apikey The bot will reply with your API key instantly.
curl https://api.polyvisionx.com/v1/hot-bets \ -H "Authorization: Bearer $POLYVISION_API_KEY"
Fourteen endpoints covering auth, analysis, scoring, trades, discovery, strategy, portfolio tracking, and health. All responses are JSON.
Get current user info, tier (premium/trial/free), premium status, and usage stats
Regenerate your API key (old key invalidated)
Permanently deactivate your API key
Full wallet analysis — P&L, risk, score, red flags
Compact copy-trading score (1-10) with red flags
Recent trade history — side, size, price, market, timestamps. Filter by since timestamp.
Daily top-10 traders with P&L, risk metrics, and copy score
Random elite trader from a curated pool of 250+ wallets
Today's profitable open positions from top traders (paginated)
Backtested copy trading strategy profiles (conservative, moderate, aggressive)
Get your tracked wallet portfolio (paginated)
Add a wallet to your tracked portfolio with an optional nickname
Remove a wallet from your tracked portfolio
System health check
Each API key gets a sliding-window per-minute budget. Limits apply identically to the REST API and the MCP HTTP transport — both share the same counter.
Active paid subscription. Burstable up to 300 requests in any rolling 60-second window.
7-day free trial users and lapsed subscribers. 30 requests in any rolling 60-second window.
Polyvision
Retry-After: 60 header. The window is sliding, not fixed — back off for ~60 seconds and you'll be unblocked. Limits are per API key (keyed on your user ID), so regenerating your key does not reset the counter.
The Model Context Protocol (MCP) lets AI assistants like Claude, Cursor, and Windsurf call Polyvision tools directly. Add one config block and your agent gains wallet analysis superpowers.
{
"mcpServers": {
"polyvision": {
"type": "streamable-http",
"url": "https://api.polyvisionx.com/mcp",
"headers": {
"Authorization": "Bearer ${POLYVISION_API_KEY}"
}
}
}
}
{
"mcpServers": {
"polyvision": {
"command": "polyvision-mcp",
"env": {
"POLYVISION_API_KEY": "pv_live_...",
"DATABASE_URL": "postgresql://..."
}
}
}
}
Run a comprehensive Polymarket wallet analysis — P&L, win rate, risk metrics, categories, copy trading score, and red flags. Quick (~5s) or full (~30-60s) mode.
Get a compact copy-trading score (1-10) with recommendation, tier, key metrics, and red flags. Shares cache with analyze_wallet.
Get recent trades for a Polymarket wallet. Returns trade history with side, size, price, market title, and timestamps. Optionally filter to trades after a given timestamp.
Get the daily top-10 traders ranked by copy score. Returns P&L, win rate, risk metrics, categories, and red flags for each trader.
Discover a random elite trader from a curated pool of 250+ wallets. Great for exploration — analyze the returned wallet for full details.
Get today's most profitable open positions from top traders. Shows entry price, current price, P&L, market details, and resolution dates.
Get pre-computed copy trading strategy profiles. Returns 3 risk profiles (conservative, moderate, aggressive) with backtested parameters, expected metrics (win rate, ROI, Sharpe, drawdown), and plain-English descriptions. Updated daily.
Get your tracked wallet portfolio. Returns wallet addresses, nicknames, scores, and notification settings. Paginated.
Add a wallet to your tracked portfolio with an optional nickname.
Remove a wallet from your tracked portfolio.
Check your usage statistics and current tier (premium/trial/free). Does not consume quota.
Check system health. Returns "ok" or "degraded" status.
Regenerate your API key. The old key is immediately invalidated. New key shown only once.
Permanently deactivate your API key. Irreversible — use regenerate_key instead if you need a replacement.
Every wallet gets a score from 0 to 10 based on win rate, P&L, risk metrics, trade frequency, and more. Here's what each tier means.
Consistently profitable, good risk management, strong track record.
Decent performance with some concerns — proceed with caution.
Mixed results, significant red flags, high risk.
Poor performance, major red flags, likely to lose money.