{"ok":true,"host":"blockrun.ai","skill_id":"fetch-polymarket-leaderboard","resource_id":"403de1f5-d4e5-4d9d-ac5b-9308f8c1c5c6","skill":{"inputs":[],"not_for":"Do not use for individual trader lookup by address or for market-specific data; this endpoint returns only the global all-time leaderboard sorted by total PnL.","outputs":[{"name":"window","type":"string","example":"all_time","required":true,"description":"Time window for the leaderboard (e.g. 'all_time')."},{"name":"sort_by","type":"string","example":"total_pnl","required":true,"description":"Metric used to sort the leaderboard (e.g. 'total_pnl')."},{"name":"entries","type":"array","example":"[{\"rank\":1,\"user\":\"0x56687bf447db6ffa42ffe2204a05edaa20f55839\",\"metrics\":{\"realized_pnl\":22053933.75,\"total_pnl\":22053933.75,\"volume\":20066524.36,\"roi\":1.099,\"trades\":16002,\"wins\":21,\"losses\":20,\"win_rate\":0.512,\"profit_factor\":185.98,\"positions_closed\":41,\"avg_buy_price\":0.522,\"avg_sell_price\":null,\"fees_paid\":0,\"fees_refunded\":0},\"trading_styles\":{\"is_whale\":true,\"primary_style\":\"WHALE\"},\"entry_edge\":null,\"first_trade_at\":1728918952}]","required":true,"description":"Ordered list of leaderboard entries, each containing rank, user wallet address, metrics, trading_styles, entry_edge, and first_trade_at."},{"name":"entries[].rank","type":"integer","example":"1","required":true,"description":"Leaderboard rank of the trader (1 = highest total PnL)."},{"name":"entries[].user","type":"string","example":"0x56687bf447db6ffa42ffe2204a05edaa20f55839","required":true,"description":"Ethereum wallet address of the ranked trader."},{"name":"entries[].metrics","type":"object","required":true,"description":"Performance metrics including realized_pnl, total_pnl, volume, roi, trades, wins, losses, win_rate, profit_factor, positions_closed, avg_buy_price, avg_sell_price, fees_paid, fees_refunded."},{"name":"entries[].trading_styles","type":"object","required":true,"description":"Boolean flags (is_whale, is_market_maker, is_active_trader, is_buy_and_hold, is_degen, is_high_conviction, is_contrarian, is_value_hunter) and a primary_style string."},{"name":"entries[].entry_edge","type":"number","example":"0.4453","required":false,"description":"Numeric edge score for the trader's entry timing; null if not available."},{"name":"entries[].first_trade_at","type":"integer","example":"1728918952","required":true,"description":"Unix timestamp of the trader's first recorded trade."}],"one_liner":"Returns the global Polymarket leaderboard of smart wallets ranked by total PnL, including per-trader metrics, trading styles, and performance statistics.","confidence":"high","skill_name":"fetch-polymarket-leaderboard","grounded_in":["accepts_schema","openapi","real_response_sample","auto_description"],"when_to_use":"Use when an agent needs to identify top-performing Polymarket traders, compare realized PnL rankings, inspect win rates or profit factors, or analyze trading styles (whale, active trader, etc.) across the prediction market platform.","display_name":"Polymarket Leaderboard","example_request":"GET https://blockrun.ai/api/v1/pm/polymarket/leaderboard","example_response_summary":"Returns a JSON object with window='all_time', sort_by='total_pnl', and an entries array of ranked traders each containing wallet address, PnL/volume/ROI metrics, trading style flags, and first trade timestamp."},"mcp_tool":{"name":"fetch_polymarket_leaderboard","description":"Returns the global Polymarket leaderboard of smart wallets ranked by total PnL, including per-trader metrics, trading styles, and performance statistics. Use when an agent needs to identify top-performing Polymarket traders, compare realized PnL rankings, inspect win rates or profit factors, or analyze trading styles (whale, active trader, etc.) across the prediction market platform.","inputSchema":{"type":"object","properties":{},"required":[]}},"anthropic_tool":{"name":"fetch_polymarket_leaderboard","description":"Returns the global Polymarket leaderboard of smart wallets ranked by total PnL, including per-trader metrics, trading styles, and performance statistics. Use when an agent needs to identify top-performing Polymarket traders, compare realized PnL rankings, inspect win rates or profit factors, or analyze trading styles (whale, active trader, etc.) across the prediction market platform.","input_schema":{"type":"object","properties":{},"required":[]}},"endpoint":{"resource_url":"https://blockrun.ai/api/v1/pm/polymarket/leaderboard","method":"GET","accepts":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","extra":{"name":"USD Coin","version":"2"},"payTo":"0x6E007731870EDe419CfB31889Cd5C4493CEcb04c","amount":"1000","scheme":"exact","network":"eip155:8453","maxTimeoutSeconds":300}]},"proof":{"txns_30d":0,"txns_lifetime":0,"clean_volume_30d_usd":0,"unique_buyers_lifetime":0,"clean_volume_lifetime_usd":0},"reliability":{"quality_score":82,"last_verified_at":"2026-05-14T16:16:59.492Z","median_latency_ms":51306,"verification_status":"pass","consecutive_failures":0},"version":1,"synthesized_at":"2026-05-15T08:37:05.935Z","merchant_approved":false,"merchant_approved_at":null,"recent_verifications":[{"attempted_at":"2026-05-31T10:32:53.667Z","paid":false,"ai_score":null,"ai_status":null,"response_status":null,"duration_ms":333},{"attempted_at":"2026-05-29T18:33:23.148Z","paid":false,"ai_score":null,"ai_status":null,"response_status":null,"duration_ms":276},{"attempted_at":"2026-05-28T18:30:45.665Z","paid":true,"ai_score":91,"ai_status":"pass","response_status":200,"duration_ms":8453},{"attempted_at":"2026-05-27T18:15:57.743Z","paid":false,"ai_score":null,"ai_status":null,"response_status":null,"duration_ms":640},{"attempted_at":"2026-05-26T18:01:08.523Z","paid":false,"ai_score":null,"ai_status":null,"response_status":null,"duration_ms":362}]}