{
  "schemaVersion": "1.0",
  "item": {
    "slug": "polyvision",
    "name": "Polyvision",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/mysticriverx/polyvision",
    "canonicalUrl": "https://clawhub.ai/mysticriverx/polyvision",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/polyvision",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polyvision",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/response-schemas.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/polyvision"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/polyvision",
    "agentPageUrl": "https://openagent3.xyz/skills/polyvision/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polyvision/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polyvision/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "PolyVision — Polymarket Wallet Analyzer",
        "body": "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, red flags, and individual open positions with entry/current prices. It also provides a daily leaderboard of top-ranked traders, hot bets (most profitable open positions from top traders), and random elite wallet discovery. Use it to evaluate whether a trader is worth copy trading, compare multiple wallets, screen for elite performers, find today's best bets, or discover new traders to follow."
      },
      {
        "title": "When to Use",
        "body": "User mentions a Polymarket wallet address (0x...)\nUser asks about copy trading, trader evaluation, or wallet scoring\nUser wants to compare prediction market traders or screen for elite performers\nUser asks about a trader's risk profile, red flags, or trading patterns\nUser asks what bets top traders are making, or wants today's best open positions\nUser wants to discover or find new Polymarket traders to follow\nUser asks about a daily leaderboard or top traders ranking\nUser wants to see a trader's individual open positions with P&L details\nUser asks about a trader's recent trades, trade history, or latest activity\nUser asks for copy trading strategy recommendations or optimal settings\nUser wants to know what risk profile or parameters to use for copy trading"
      },
      {
        "title": "When NOT to Use",
        "body": "General crypto price queries (not Polymarket-specific)\nPlacing trades or executing orders (PolyVision is read-only analysis)\nNon-Polymarket wallet lookups (Ethereum DeFi, NFTs, etc.)"
      },
      {
        "title": "Setup: MCP Server (Recommended)",
        "body": "Add to your MCP client configuration (e.g. claude_desktop_config.json, Cursor, Windsurf):\n\n{\n  \"mcpServers\": {\n    \"polyvision\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://api.polyvisionx.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${POLYVISION_API_KEY}\"\n      }\n    }\n  }\n}"
      },
      {
        "title": "Setup: Get an API Key",
        "body": "Get a free API key (no daily limits) from the Telegram bot:\n\nOpen the PolyVision bot on Telegram\nRun /apikey to generate your key\nCopy the pv_live_... key (shown only once, store it securely)\n\nSet it as an environment variable:\n\nexport POLYVISION_API_KEY=\"pv_live_abc123...\"\n\nFull API docs: https://polyvisionx.com/docs"
      },
      {
        "title": "analyze_wallet",
        "body": "Run a comprehensive Polymarket wallet analysis.\n\nParameterTypeRequiredDefaultDescriptionwallet_addressstringYes—Ethereum address (42 chars, starts with 0x)modestringNo\"quick\"\"quick\" (~5s) or \"full\" (~30-60s with timing data)\n\nReturns: 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.\n\nTiming: Quick mode ~5s, full mode ~30-60s. Cached responses are instant."
      },
      {
        "title": "get_score",
        "body": "Get a compact copy-trading score for a wallet. Shares the same cache as analyze_wallet.\n\nParameterTypeRequiredDescriptionwallet_addressstringYesEthereum address (42 chars, starts with 0x)\n\nReturns: 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.\n\nTiming: ~5s fresh, instant if cached."
      },
      {
        "title": "get_hot_bets",
        "body": "Get today's hot bets from top traders. Returns the most profitable open positions from top-ranked Polymarket traders, sourced from the daily strategy report.\n\nParameterTypeRequiredDefaultDescriptionlimitintegerNo20Maximum number of bets to returnsort_bystringNo\"rank\"\"rank\" (default) or \"pnl\"\n\nReturns: Scan date, total count, and list of hot bets — each with trader info (wallet, username, score, win rate), market details (title, slug, outcome), pricing (entry price, current price, current value), P&L (unrealized P&L, percent), resolution info (end date, days until resolution), entry timing (entry date, days since entry, hold hours), and Polymarket URL. See references/response-schemas.md for the complete field reference."
      },
      {
        "title": "get_leaderboard",
        "body": "Get the daily top-10 leaderboard of ranked Polymarket traders. Synced daily from the scan pipeline.\n\nParameterTypeRequiredDefaultDescriptionsort_bystringNo\"rank\"\"rank\" (default), \"score\", or \"pnl\"\n\nReturns: Scan date, total count, and list of leaderboard entries — each with wallet address, username, total P&L, volume, ROI%, win rate, risk metrics (Sharpe ratio, max drawdown, profit factor), copy score (1-10), recommendation, tier (green/yellow/orange/red), red flags, track record days, last trade date, and category percentages (politics, crypto, sports). See references/response-schemas.md for the complete field reference."
      },
      {
        "title": "get_strategy",
        "body": "Get pre-computed copy trading strategy profiles. Returns 3 risk profiles (conservative, moderate, aggressive) with backtested parameters and expected metrics, updated daily.\n\nParameters: None\n\nReturns: Scan date, total count, and list of strategy profiles — each with parameters (price range, min score, max trades/day, min trade size, position sizing method), backtest results (win rate, ROI, Sharpe ratio, max drawdown, profit factor, EV/trade, total P&L), cost-adjusted results, and a plain-English description. See references/response-schemas.md for the complete field reference."
      },
      {
        "title": "get_recent_trades",
        "body": "Get recent trades for a Polymarket wallet. Returns trade history with side, size, price, market title, and timestamps.\n\nParameterTypeRequiredDefaultDescriptionwallet_addressstringYes—Ethereum address (42 chars, starts with 0x)sinceintegerNo—Unix timestamp — only return trades after this timelimitintegerNo50Max trades to return (1-100)\n\nReturns: Dict with wallet_address, since, count, and trades list — each trade with side (BUY/SELL), size, price, timestamp, market title, outcome, slug, and transaction hash. See references/response-schemas.md for the complete field reference."
      },
      {
        "title": "discover_wallet",
        "body": "Discover a random elite trader from the curated wallet pool (250+). Returns a random wallet address each call — use analyze_wallet or get_score to investigate it.\n\nParameters: None\n\nReturns: { \"wallet_address\": \"0x...\", \"pool_size\": 250, \"message\": \"...\" }"
      },
      {
        "title": "check_quota",
        "body": "Check your usage statistics. Does not consume quota.\n\nParameters: None\n\nReturns: { \"used_today\": <int>, \"tier\": \"api\" }\n\nAPI/MCP access has no daily limits — usage is tracked for analytics only."
      },
      {
        "title": "get_portfolio",
        "body": "Get the user's tracked wallet portfolio with scores and nicknames.\n\nParameterTypeRequiredDefaultDescriptionpageintegerNo0Page number (0-indexed)limitintegerNo10Results per page (1-50)\n\nReturns: Dict with total_count, page, limit, and wallets list — each with wallet address, nickname, score, last analyzed date, and notifications status. See references/response-schemas.md for the complete field reference."
      },
      {
        "title": "add_to_portfolio",
        "body": "Add a wallet to the user's portfolio for tracking.\n\nParameterTypeRequiredDefaultDescriptionwallet_addressstringYes—Ethereum address (42 chars, starts with 0x)nicknamestringNo—Display name (defaults to first 10 chars of address)\n\nReturns: Dict with wallet_address, nickname, and message on success, or dict with error key on failure (duplicate, limit reached).\n\nLimits: Free users: 3 wallets. Premium users: 20 wallets."
      },
      {
        "title": "remove_from_portfolio",
        "body": "Remove a wallet from the user's portfolio.\n\nParameterTypeRequiredDescriptionwallet_addressstringYesEthereum address to remove\n\nReturns: Dict with wallet_address and message on success, or dict with error key if wallet not found."
      },
      {
        "title": "health",
        "body": "Check system health.\n\nParameters: None\n\nReturns: { \"status\": \"ok\" } or { \"status\": \"degraded\" }"
      },
      {
        "title": "Score Tiers",
        "body": "TierScore RangeRecommendationMeaningGreen8.0 – 10.0Strong CopyConsistently profitable, good risk management, strong track recordYellow6.0 – 7.9Moderate CopyDecent performance with some concerns, proceed with cautionOrange4.0 – 5.9Risky CopyMixed results, significant red flags, high riskRed0.0 – 3.9Don't CopyPoor performance, major red flags, likely to lose money"
      },
      {
        "title": "Decision Table",
        "body": "User IntentToolModeWhy\"Should I copy this trader?\"get_score—Quick yes/no with score + red flags\"Deep dive on this wallet\"analyze_walletfullComplete analysis with timing data\"Quick check on a wallet\"analyze_walletquickFull analysis without activity timing\"What are this trader's open positions?\"analyze_walletquickopen_positions_detail in analysis response\"Compare two traders\"get_score x2—Side-by-side scores for fast comparison\"What categories does this trader focus on?\"analyze_walletquickCategory breakdown in analysis\"What are the best bets right now?\"get_hot_bets—Today's most profitable open positions from top traders\"What bets are top traders making?\"get_hot_betssort=pnlHot bets sorted by P&L\"Who are the top traders today?\"get_leaderboard—Daily top-10 ranked traders\"Find me a good trader to follow\"discover_wallet—Random elite wallet, then get_score or analyze_wallet\"What trades has this wallet made recently?\"get_recent_trades—Recent trade history for a wallet\"What strategy should I use for copy trading?\"get_strategy—3 risk profiles with backtested parameters\"What's the safest way to copy trade?\"get_strategy—Conservative profile with low drawdown\"Discover new traders\"discover_wallet x3—Multiple random picks to explore\"Show my tracked wallets\"get_portfolio—View portfolio with scores and nicknames\"Add this wallet to my portfolio\"add_to_portfolio—Track a wallet with optional nickname\"Remove wallet from portfolio\"remove_from_portfolio—Stop tracking a wallet\"Is the system up?\"health—System status check\"How many analyses have I run?\"check_quota—Usage stats (no limits enforced)"
      },
      {
        "title": "Red Flag Reference",
        "body": "Red flags are returned as a list of strings. Here's what each one means:\n\nRed FlagTriggerSeverityLow win rateWin rate below 40%HighLarge single lossSingle worst trade exceeds 50% of total P&LMediumOverall unprofitableNet P&L is negativeHighLimited track recordFewer than 10 closed positionsMediumInactiveNo trades in 30+ daysLowBOT ALERTMedian trade duration under 5 minutesHighVery fast tradingMedian trade duration under 30 minutesMediumLOSS HIDING70%+ of open positions underwater (5+ open)HighOpen positions losing50%+ of open positions underwater (3+ open)MediumNo major red flags detectedNo concerning patterns foundNone"
      },
      {
        "title": "REST API (Alternative)",
        "body": "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).\n\nInteractive docs and the OpenAPI spec are available at:\n\nSwagger UI: https://api.polyvisionx.com/docs\nOpenAPI JSON: https://api.polyvisionx.com/openapi.json\n\nEndpointMethodDescriptionGET /v1/auth/meGETGet current user info and usage statsGET /v1/analyze/{wallet_address}?mode=quickGETFull wallet analysis (includes open_positions_detail)GET /v1/score/{wallet_address}GETCompact copy-trading scoreGET /v1/hot-bets?page=0&limit=20&sort_by=rankGETToday's hot bets from top tradersGET /v1/leaderboard?sort_by=rankGETDaily top-10 leaderboardGET /v1/strategyGETPre-computed copy trading strategy profiles (3 risk levels)GET /v1/trades/{wallet_address}?since=&limit=50GETRecent trades for a walletGET /v1/discoverGETDiscover a random elite traderGET /v1/portfolio?page=0&limit=10GETGet your tracked wallet portfolioPOST /v1/portfolioPOSTAdd a wallet to your portfolio (JSON body: wallet_address, nickname)DELETE /v1/portfolio/{wallet_address}DELETERemove a wallet from your portfolioGET /healthGETHealth check (no auth required)"
      },
      {
        "title": "Example: Analyze a wallet",
        "body": "curl -s https://api.polyvisionx.com/v1/analyze/0x1234...abcd?mode=quick \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq ."
      },
      {
        "title": "Example: Get a score",
        "body": "curl -s https://api.polyvisionx.com/v1/score/0x1234...abcd \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq ."
      },
      {
        "title": "Example: Get hot bets",
        "body": "curl -s https://api.polyvisionx.com/v1/hot-bets?sort_by=pnl \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq ."
      },
      {
        "title": "Example: Get leaderboard",
        "body": "curl -s https://api.polyvisionx.com/v1/leaderboard \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq ."
      },
      {
        "title": "Example: Get strategy profiles",
        "body": "curl -s https://api.polyvisionx.com/v1/strategy \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq ."
      },
      {
        "title": "Example: Discover a random trader",
        "body": "curl -s https://api.polyvisionx.com/v1/discover \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq ."
      },
      {
        "title": "Error Codes",
        "body": "CodeMeaningRecovery400Invalid wallet address (must be 42-char hex starting with 0x)Fix the address format401Invalid or inactive API keyGet a key from the PolyVision Telegram bot via /apikey429Rate limitedWait and retry — Polymarket API has upstream limits503System at capacity (all analysis slots in use)Retry in 30-60 seconds502Upstream Polymarket API errorRetry — the upstream data API may be temporarily unavailable504Analysis timed outRetry — the wallet may have extensive history"
      }
    ],
    "body": "PolyVision — Polymarket Wallet Analyzer\n\nPolyVision 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, red flags, and individual open positions with entry/current prices. It also provides a daily leaderboard of top-ranked traders, hot bets (most profitable open positions from top traders), and random elite wallet discovery. Use it to evaluate whether a trader is worth copy trading, compare multiple wallets, screen for elite performers, find today's best bets, or discover new traders to follow.\n\nWhen to Use\nUser mentions a Polymarket wallet address (0x...)\nUser asks about copy trading, trader evaluation, or wallet scoring\nUser wants to compare prediction market traders or screen for elite performers\nUser asks about a trader's risk profile, red flags, or trading patterns\nUser asks what bets top traders are making, or wants today's best open positions\nUser wants to discover or find new Polymarket traders to follow\nUser asks about a daily leaderboard or top traders ranking\nUser wants to see a trader's individual open positions with P&L details\nUser asks about a trader's recent trades, trade history, or latest activity\nUser asks for copy trading strategy recommendations or optimal settings\nUser wants to know what risk profile or parameters to use for copy trading\nWhen NOT to Use\nGeneral crypto price queries (not Polymarket-specific)\nPlacing trades or executing orders (PolyVision is read-only analysis)\nNon-Polymarket wallet lookups (Ethereum DeFi, NFTs, etc.)\nSetup: MCP Server (Recommended)\n\nAdd to your MCP client configuration (e.g. claude_desktop_config.json, Cursor, Windsurf):\n\n{\n  \"mcpServers\": {\n    \"polyvision\": {\n      \"type\": \"streamable-http\",\n      \"url\": \"https://api.polyvisionx.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${POLYVISION_API_KEY}\"\n      }\n    }\n  }\n}\n\nSetup: Get an API Key\n\nGet a free API key (no daily limits) from the Telegram bot:\n\nOpen the PolyVision bot on Telegram\nRun /apikey to generate your key\nCopy the pv_live_... key (shown only once, store it securely)\n\nSet it as an environment variable:\n\nexport POLYVISION_API_KEY=\"pv_live_abc123...\"\n\n\nFull API docs: https://polyvisionx.com/docs\n\nMCP Tools Reference\nanalyze_wallet\n\nRun a comprehensive Polymarket wallet analysis.\n\nParameter\tType\tRequired\tDefault\tDescription\nwallet_address\tstring\tYes\t—\tEthereum address (42 chars, starts with 0x)\nmode\tstring\tNo\t\"quick\"\t\"quick\" (~5s) or \"full\" (~30-60s with timing data)\n\nReturns: 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.\n\nTiming: Quick mode ~5s, full mode ~30-60s. Cached responses are instant.\n\nget_score\n\nGet a compact copy-trading score for a wallet. Shares the same cache as analyze_wallet.\n\nParameter\tType\tRequired\tDescription\nwallet_address\tstring\tYes\tEthereum address (42 chars, starts with 0x)\n\nReturns: 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.\n\nTiming: ~5s fresh, instant if cached.\n\nget_hot_bets\n\nGet today's hot bets from top traders. Returns the most profitable open positions from top-ranked Polymarket traders, sourced from the daily strategy report.\n\nParameter\tType\tRequired\tDefault\tDescription\nlimit\tinteger\tNo\t20\tMaximum number of bets to return\nsort_by\tstring\tNo\t\"rank\"\t\"rank\" (default) or \"pnl\"\n\nReturns: Scan date, total count, and list of hot bets — each with trader info (wallet, username, score, win rate), market details (title, slug, outcome), pricing (entry price, current price, current value), P&L (unrealized P&L, percent), resolution info (end date, days until resolution), entry timing (entry date, days since entry, hold hours), and Polymarket URL. See references/response-schemas.md for the complete field reference.\n\nget_leaderboard\n\nGet the daily top-10 leaderboard of ranked Polymarket traders. Synced daily from the scan pipeline.\n\nParameter\tType\tRequired\tDefault\tDescription\nsort_by\tstring\tNo\t\"rank\"\t\"rank\" (default), \"score\", or \"pnl\"\n\nReturns: Scan date, total count, and list of leaderboard entries — each with wallet address, username, total P&L, volume, ROI%, win rate, risk metrics (Sharpe ratio, max drawdown, profit factor), copy score (1-10), recommendation, tier (green/yellow/orange/red), red flags, track record days, last trade date, and category percentages (politics, crypto, sports). See references/response-schemas.md for the complete field reference.\n\nget_strategy\n\nGet pre-computed copy trading strategy profiles. Returns 3 risk profiles (conservative, moderate, aggressive) with backtested parameters and expected metrics, updated daily.\n\nParameters: None\n\nReturns: Scan date, total count, and list of strategy profiles — each with parameters (price range, min score, max trades/day, min trade size, position sizing method), backtest results (win rate, ROI, Sharpe ratio, max drawdown, profit factor, EV/trade, total P&L), cost-adjusted results, and a plain-English description. See references/response-schemas.md for the complete field reference.\n\nget_recent_trades\n\nGet recent trades for a Polymarket wallet. Returns trade history with side, size, price, market title, and timestamps.\n\nParameter\tType\tRequired\tDefault\tDescription\nwallet_address\tstring\tYes\t—\tEthereum address (42 chars, starts with 0x)\nsince\tinteger\tNo\t—\tUnix timestamp — only return trades after this time\nlimit\tinteger\tNo\t50\tMax trades to return (1-100)\n\nReturns: Dict with wallet_address, since, count, and trades list — each trade with side (BUY/SELL), size, price, timestamp, market title, outcome, slug, and transaction hash. See references/response-schemas.md for the complete field reference.\n\ndiscover_wallet\n\nDiscover a random elite trader from the curated wallet pool (250+). Returns a random wallet address each call — use analyze_wallet or get_score to investigate it.\n\nParameters: None\n\nReturns: { \"wallet_address\": \"0x...\", \"pool_size\": 250, \"message\": \"...\" }\n\ncheck_quota\n\nCheck your usage statistics. Does not consume quota.\n\nParameters: None\n\nReturns: { \"used_today\": <int>, \"tier\": \"api\" }\n\nAPI/MCP access has no daily limits — usage is tracked for analytics only.\n\nget_portfolio\n\nGet the user's tracked wallet portfolio with scores and nicknames.\n\nParameter\tType\tRequired\tDefault\tDescription\npage\tinteger\tNo\t0\tPage number (0-indexed)\nlimit\tinteger\tNo\t10\tResults per page (1-50)\n\nReturns: Dict with total_count, page, limit, and wallets list — each with wallet address, nickname, score, last analyzed date, and notifications status. See references/response-schemas.md for the complete field reference.\n\nadd_to_portfolio\n\nAdd a wallet to the user's portfolio for tracking.\n\nParameter\tType\tRequired\tDefault\tDescription\nwallet_address\tstring\tYes\t—\tEthereum address (42 chars, starts with 0x)\nnickname\tstring\tNo\t—\tDisplay name (defaults to first 10 chars of address)\n\nReturns: Dict with wallet_address, nickname, and message on success, or dict with error key on failure (duplicate, limit reached).\n\nLimits: Free users: 3 wallets. Premium users: 20 wallets.\n\nremove_from_portfolio\n\nRemove a wallet from the user's portfolio.\n\nParameter\tType\tRequired\tDescription\nwallet_address\tstring\tYes\tEthereum address to remove\n\nReturns: Dict with wallet_address and message on success, or dict with error key if wallet not found.\n\nhealth\n\nCheck system health.\n\nParameters: None\n\nReturns: { \"status\": \"ok\" } or { \"status\": \"degraded\" }\n\nScore Tiers\nTier\tScore Range\tRecommendation\tMeaning\nGreen\t8.0 – 10.0\tStrong Copy\tConsistently profitable, good risk management, strong track record\nYellow\t6.0 – 7.9\tModerate Copy\tDecent performance with some concerns, proceed with caution\nOrange\t4.0 – 5.9\tRisky Copy\tMixed results, significant red flags, high risk\nRed\t0.0 – 3.9\tDon't Copy\tPoor performance, major red flags, likely to lose money\nDecision Table\nUser Intent\tTool\tMode\tWhy\n\"Should I copy this trader?\"\tget_score\t—\tQuick yes/no with score + red flags\n\"Deep dive on this wallet\"\tanalyze_wallet\tfull\tComplete analysis with timing data\n\"Quick check on a wallet\"\tanalyze_wallet\tquick\tFull analysis without activity timing\n\"What are this trader's open positions?\"\tanalyze_wallet\tquick\topen_positions_detail in analysis response\n\"Compare two traders\"\tget_score x2\t—\tSide-by-side scores for fast comparison\n\"What categories does this trader focus on?\"\tanalyze_wallet\tquick\tCategory breakdown in analysis\n\"What are the best bets right now?\"\tget_hot_bets\t—\tToday's most profitable open positions from top traders\n\"What bets are top traders making?\"\tget_hot_bets\tsort=pnl\tHot bets sorted by P&L\n\"Who are the top traders today?\"\tget_leaderboard\t—\tDaily top-10 ranked traders\n\"Find me a good trader to follow\"\tdiscover_wallet\t—\tRandom elite wallet, then get_score or analyze_wallet\n\"What trades has this wallet made recently?\"\tget_recent_trades\t—\tRecent trade history for a wallet\n\"What strategy should I use for copy trading?\"\tget_strategy\t—\t3 risk profiles with backtested parameters\n\"What's the safest way to copy trade?\"\tget_strategy\t—\tConservative profile with low drawdown\n\"Discover new traders\"\tdiscover_wallet x3\t—\tMultiple random picks to explore\n\"Show my tracked wallets\"\tget_portfolio\t—\tView portfolio with scores and nicknames\n\"Add this wallet to my portfolio\"\tadd_to_portfolio\t—\tTrack a wallet with optional nickname\n\"Remove wallet from portfolio\"\tremove_from_portfolio\t—\tStop tracking a wallet\n\"Is the system up?\"\thealth\t—\tSystem status check\n\"How many analyses have I run?\"\tcheck_quota\t—\tUsage stats (no limits enforced)\nRed Flag Reference\n\nRed flags are returned as a list of strings. Here's what each one means:\n\nRed Flag\tTrigger\tSeverity\nLow win rate\tWin rate below 40%\tHigh\nLarge single loss\tSingle worst trade exceeds 50% of total P&L\tMedium\nOverall unprofitable\tNet P&L is negative\tHigh\nLimited track record\tFewer than 10 closed positions\tMedium\nInactive\tNo trades in 30+ days\tLow\nBOT ALERT\tMedian trade duration under 5 minutes\tHigh\nVery fast trading\tMedian trade duration under 30 minutes\tMedium\nLOSS HIDING\t70%+ of open positions underwater (5+ open)\tHigh\nOpen positions losing\t50%+ of open positions underwater (3+ open)\tMedium\nNo major red flags detected\tNo concerning patterns found\tNone\nREST API (Alternative)\n\nFor 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).\n\nInteractive docs and the OpenAPI spec are available at:\n\nSwagger UI: https://api.polyvisionx.com/docs\nOpenAPI JSON: https://api.polyvisionx.com/openapi.json\nEndpoint\tMethod\tDescription\nGET /v1/auth/me\tGET\tGet current user info and usage stats\nGET /v1/analyze/{wallet_address}?mode=quick\tGET\tFull wallet analysis (includes open_positions_detail)\nGET /v1/score/{wallet_address}\tGET\tCompact copy-trading score\nGET /v1/hot-bets?page=0&limit=20&sort_by=rank\tGET\tToday's hot bets from top traders\nGET /v1/leaderboard?sort_by=rank\tGET\tDaily top-10 leaderboard\nGET /v1/strategy\tGET\tPre-computed copy trading strategy profiles (3 risk levels)\nGET /v1/trades/{wallet_address}?since=&limit=50\tGET\tRecent trades for a wallet\nGET /v1/discover\tGET\tDiscover a random elite trader\nGET /v1/portfolio?page=0&limit=10\tGET\tGet your tracked wallet portfolio\nPOST /v1/portfolio\tPOST\tAdd a wallet to your portfolio (JSON body: wallet_address, nickname)\nDELETE /v1/portfolio/{wallet_address}\tDELETE\tRemove a wallet from your portfolio\nGET /health\tGET\tHealth check (no auth required)\nExample: Analyze a wallet\ncurl -s https://api.polyvisionx.com/v1/analyze/0x1234...abcd?mode=quick \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq .\n\nExample: Get a score\ncurl -s https://api.polyvisionx.com/v1/score/0x1234...abcd \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq .\n\nExample: Get hot bets\ncurl -s https://api.polyvisionx.com/v1/hot-bets?sort_by=pnl \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq .\n\nExample: Get leaderboard\ncurl -s https://api.polyvisionx.com/v1/leaderboard \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq .\n\nExample: Get strategy profiles\ncurl -s https://api.polyvisionx.com/v1/strategy \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq .\n\nExample: Discover a random trader\ncurl -s https://api.polyvisionx.com/v1/discover \\\n  -H \"Authorization: Bearer $POLYVISION_API_KEY\" | jq .\n\nError Codes\nCode\tMeaning\tRecovery\n400\tInvalid wallet address (must be 42-char hex starting with 0x)\tFix the address format\n401\tInvalid or inactive API key\tGet a key from the PolyVision Telegram bot via /apikey\n429\tRate limited\tWait and retry — Polymarket API has upstream limits\n503\tSystem at capacity (all analysis slots in use)\tRetry in 30-60 seconds\n502\tUpstream Polymarket API error\tRetry — the upstream data API may be temporarily unavailable\n504\tAnalysis timed out\tRetry — the wallet may have extensive history"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/mysticriverx/polyvision",
    "publisherUrl": "https://clawhub.ai/mysticriverx/polyvision",
    "owner": "mysticriverx",
    "version": "1.0.12",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/polyvision",
    "downloadUrl": "https://openagent3.xyz/downloads/polyvision",
    "agentUrl": "https://openagent3.xyz/skills/polyvision/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polyvision/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polyvision/agent.md"
  }
}