PolyVision — Polymarket Wallet Analyzer

PolyVision analyzes Polymarket prediction market wallets and returns a comprehensive trading profile: copy trading score (1-10), P&L breakdown, win rate, risk metrics (Sharpe ratio, Sortino ratio, max drawdown), position sizing consistency, market category performance, recent performance windows (7d/30d/90d), streak analysis, and red flags. Use it to evaluate whether a trader is worth copy trading, compare multiple wallets, or screen for elite performers.

When to Use

• User mentions a Polymarket wallet address (0x...)
• User asks about copy trading, trader evaluation, or wallet scoring
• User wants to compare prediction market traders or screen for elite performers
• User asks about a trader's risk profile, red flags, or trading patterns

When NOT to Use

• General crypto price queries (not Polymarket-specific)
• Placing trades or executing orders (PolyVision is read-only analysis)
• Non-Polymarket wallet lookups (Ethereum DeFi, NFTs, etc.)

Setup: MCP Server (Recommended)

Add to your MCP client configuration (e.g. claude_desktop_config.json, Cursor, Windsurf):

{
  "mcpServers": {
    "polyvision": {
      "type": "streamable-http",
      "url": "https://api.polyvisionx.com/mcp",
      "headers": {
        "Authorization": "Bearer ${POLYVISION_API_KEY}"
      }
    }
  }
}

Alternative — stdio transport (requires local install + database):

{
  "mcpServers": {
    "polyvision": {
      "command": "polyvision-mcp",
      "env": {
        "POLYVISION_API_KEY": "pv_live_...",
        "DATABASE_URL": "postgresql://..."
      }
    }
  }
}

Setup: Get an API Key

Register for a free API key (no daily limits):

curl -X POST https://api.polyvisionx.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "My App"}'

Response:

{
  "api_key": "pv_live_abc123...",
  "key_prefix": "pv_live_abc12345",
  "tier": "api"
}

Store the key — it is shown only once and cannot be retrieved later. Set it as an environment variable:

export POLYVISION_API_KEY="pv_live_abc123..."

MCP Tools Reference

analyze_wallet

Run a comprehensive Polymarket wallet analysis.

Returns: Full analysis dict with P&L, win rate, risk metrics, categories, copy trading score (1-10), red flags, and usage info. Results are cached for 6 hours — cache hits are instant. See references/response-schemas.md for the complete field reference.

Timing: Quick mode ~5s, full mode ~30-60s. Cached responses are instant.

get_score

Get a compact copy-trading score for a wallet. Shares the same cache as analyze_wallet.

Returns: Score (1-10), recommendation, tier (green/yellow/orange/red), total P&L, win rate, trade count, Sharpe ratio, red flags, cache status, and usage info.

Timing: ~5s fresh, instant if cached.

check_quota

Check your usage statistics. Does not consume quota.

Parameters: None

Returns: { "used_today": <int>, "tier": "api" }

API/MCP access has no daily limits — usage is tracked for analytics only.

health

Check system health.

Parameters: None

Returns: { "status": "ok" } or { "status": "degraded" }

regenerate_key

Regenerate your API key. The old key is immediately invalidated.

Parameters: None

Returns: { "api_key": "pv_live_...", "key_prefix": "pv_live_...", "message": "..." }

The new key is shown only once. Update your configuration immediately.

deactivate_key

Permanently deactivate your API key. This is irreversible — use regenerate_key instead if you need a replacement.

Parameters: None

Returns: { "success": true, "message": "API key deactivated. All future requests with this key will be rejected." }

Score Tiers

Decision Table

Red Flag Reference

Red flags are returned as a list of strings. Here's what each one means:

REST API (Alternative)

For agents that cannot use MCP, all tools are available as REST endpoints at https://api.polyvisionx.com. Most endpoints require Bearer token authentication (exceptions noted below).

Interactive docs and the OpenAPI spec are available at:

• Swagger UI: https://api.polyvisionx.com/docs
• OpenAPI JSON: https://api.polyvisionx.com/openapi.json

Example: Analyze a wallet

curl -s https://api.polyvisionx.com/v1/analyze/0x1234...abcd?mode=quick \
  -H "Authorization: Bearer $POLYVISION_API_KEY" | jq .

Example: Get a score

curl -s https://api.polyvisionx.com/v1/score/0x1234...abcd \
  -H "Authorization: Bearer $POLYVISION_API_KEY" | jq .

Error Codes