Polyvision
Build on Polyvision
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 — card required to start, $0 today, cancel anytime.
Listed on ClawHubGet Started in 30 Seconds
Get a free API key from our Telegram bot, then start your 7-day trial. Two steps. That's it.
1. Get an API key via Telegram
Open @PolyVisionBot on Telegram and type the command below into the chat: /apikey The bot will reply with your API key instantly.
2. Pull today's hot bets
curl https://api.polyvisionx.com/v1/hot-bets \ -H "Authorization: Bearer $POLYVISION_API_KEY"
API Endpoints
Sixteen endpoints covering auth, analysis, scoring, trades, batch trades, discovery, strategy, the consistent-traders pool, 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.
Recent trades for up to 5 wallets in one request, fetched in parallel. Per-wallet errors returned individually. Counts as one request per wallet against your rate limit.
Daily top-10 traders with P&L, risk metrics, and copy score
Browse the consistent-traders pool — a historically-vetted set of wallets. Filter by category (sports, crypto, politics); sort by score, P&L, or win rate. Paginated.
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
Per-User Request Caps
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.
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. Batch trade requests (POST /v1/trades/batch) cost one request per wallet, and a separate per-IP cap of 60 req/min applies across all endpoints.
Connect Your AI Agent
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. New to MCP? Start with the Polymarket MCP server guide.
{
"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://..."
}
}
}
}
Available Tools
analyze_wallet
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_score
Get a compact copy-trading score (1-10) with recommendation, tier, key metrics, and red flags. Shares cache with analyze_wallet.
get_recent_trades
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_leaderboard
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_wallet
Discover a random elite trader from a curated pool of 250+ wallets. Great for exploration — analyze the returned wallet for full details.
get_wallet_pool
NewBrowse the consistent-traders pool — historically-vetted wallets. Filter by category (sports, crypto, politics) and sort by score, P&L, or win rate. Paginated.
get_hot_bets
Get today's most profitable open positions from top traders. Shows entry price, current price, P&L, market details, and resolution dates.
get_strategy
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_portfolio
NewGet your tracked wallet portfolio. Returns wallet addresses, nicknames, scores, and notification settings. Paginated.
add_to_portfolio
NewAdd a wallet to your tracked portfolio with an optional nickname.
remove_from_portfolio
NewRemove a wallet from your tracked portfolio.
check_quota
Check your usage statistics and current tier (premium/trial/free). Does not consume quota.
health
Check system health. Returns "ok" or "degraded" status.
regenerate_key
Regenerate your API key. The old key is immediately invalidated. New key shown only once.
deactivate_key
Permanently deactivate your API key. Irreversible — use regenerate_key instead if you need a replacement.
calculate
NewEvaluate a math expression deterministically — position sizing, ROI, and payout math. Safe arithmetic only, never code execution.
get_knowledge
NewLook up Polyvision's copy-trading methodology and how the daily reports work — scoring tiers, position sizing, red flags, and getting started.
Copy Trading Score System
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.