{"uid":"cap_B1pS5l7JjyB9nU_3pYFdH","slug":"blockrun-ai-f4438bd7","name":"BlockRun.AI Polymarket Wallet Performance Metrics","description":"Returns trading performance metrics and style classification for a Polymarket wallet, including PnL, volume, ROI, win rate, positions, and recent activity.","url":"https://blockrun.ai/api/v1/pm/polymarket/wallet/0x17db3fcd93ba12d38382a0cade24b200185c5f6d","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":{"type":"object","required":["user","metrics","total_pnl","entry_edge","computed_at","last_trade_at","first_trade_at","trading_styles","unrealized_pnl"],"properties":{"user":{"type":"string"},"metrics":{"type":"object","required":["one_day","all_time","seven_day","thirty_day"],"properties":{"one_day":{"type":"object","required":["roi","wins","losses","trades","volume","win_rate","fees_paid","total_pnl","realized_pnl","avg_buy_price","fees_refunded","profit_factor","avg_sell_price","positions_closed"],"properties":{"roi":{"type":"number"},"wins":{"type":"number"},"losses":{"type":"number"},"trades":{"type":"number"},"volume":{"type":"number"},"win_rate":{"type":"number"},"fees_paid":{"type":"number"},"total_pnl":{"type":"number"},"realized_pnl":{"type":"number"},"avg_buy_price":{"type":"null"},"fees_refunded":{"type":"number"},"profit_factor":{"type":"number"},"avg_sell_price":{"type":"null"},"positions_closed":{"type":"number"}}},"all_time":{"type":"object","required":["roi","wins","losses","trades","volume","win_rate","fees_paid","total_pnl","realized_pnl","avg_buy_price","fees_refunded","profit_factor","avg_sell_price","max_win_streak","max_loss_streak","total_positions","wallet_age_days","active_positions","positions_closed","avg_hold_time_seconds","best_position_realized_pnl","worst_position_realized_pnl"],"properties":{"roi":{"type":"number"},"wins":{"type":"number"},"losses":{"type":"number"},"trades":{"type":"number"},"volume":{"type":"number"},"win_rate":{"type":"number"},"fees_paid":{"type":"number"},"total_pnl":{"type":"number"},"realized_pnl":{"type":"number"},"avg_buy_price":{"type":"number"},"fees_refunded":{"type":"number"},"profit_factor":{"type":"number"},"avg_sell_price":{"type":"number"},"max_win_streak":{"type":"number"},"max_loss_streak":{"type":"number"},"total_positions":{"type":"number"},"wallet_age_days":{"type":"number"},"active_positions":{"type":"number"},"positions_closed":{"type":"number"},"avg_hold_time_seconds":{"type":"number"},"best_position_realized_pnl":{"type":"number"},"worst_position_realized_pnl":{"type":"number"}}},"seven_day":{"type":"object","required":["roi","wins","losses","trades","volume","win_rate","fees_paid","total_pnl","realized_pnl","avg_buy_price","fees_refunded","profit_factor","avg_sell_price","positions_closed"],"properties":{"roi":{"type":"number"},"wins":{"type":"number"},"losses":{"type":"number"},"trades":{"type":"number"},"volume":{"type":"number"},"win_rate":{"type":"number"},"fees_paid":{"type":"number"},"total_pnl":{"type":"number"},"realized_pnl":{"type":"number"},"avg_buy_price":{"type":"null"},"fees_refunded":{"type":"number"},"profit_factor":{"type":"number"},"avg_sell_price":{"type":"null"},"positions_closed":{"type":"number"}}},"thirty_day":{"type":"object","required":["roi","wins","losses","trades","volume","win_rate","fees_paid","total_pnl","realized_pnl","avg_buy_price","fees_refunded","profit_factor","avg_sell_price","positions_closed"],"properties":{"roi":{"type":"number"},"wins":{"type":"number"},"losses":{"type":"number"},"trades":{"type":"number"},"volume":{"type":"number"},"win_rate":{"type":"number"},"fees_paid":{"type":"number"},"total_pnl":{"type":"number"},"realized_pnl":{"type":"number"},"avg_buy_price":{"type":"null"},"fees_refunded":{"type":"number"},"profit_factor":{"type":"number"},"avg_sell_price":{"type":"null"},"positions_closed":{"type":"number"}}}}},"total_pnl":{"type":"number"},"entry_edge":{"type":"number"},"computed_at":{"type":"number"},"last_trade_at":{"type":"number"},"first_trade_at":{"type":"number"},"trading_styles":{"type":"object","required":["is_degen","is_whale","is_contrarian","primary_style","is_buy_and_hold","is_market_maker","is_value_hunter","is_active_trader","is_high_conviction"],"properties":{"is_degen":{"type":"boolean"},"is_whale":{"type":"boolean"},"is_contrarian":{"type":"boolean"},"primary_style":{"type":"string"},"is_buy_and_hold":{"type":"boolean"},"is_market_maker":{"type":"boolean"},"is_value_hunter":{"type":"boolean"},"is_active_trader":{"type":"boolean"},"is_high_conviction":{"type":"boolean"}}},"unrealized_pnl":{"type":"number"}}},"example":{"request":{"input":{"body":{}}},"response":{"user":"0x17db3fcd93ba12d38382a0cade24b200185c5f6d","metrics":{"one_day":{"roi":0,"wins":0,"losses":0,"trades":0,"volume":0,"win_rate":0,"fees_paid":0,"total_pnl":0,"realized_pnl":0,"avg_buy_price":null,"fees_refunded":0,"profit_factor":0,"avg_sell_price":null,"positions_closed":0},"all_time":{"roi":0.296245105921963,"wins":94,"losses":26,"trades":4346,"volume":12004717.046816,"win_rate":0.783333333333333,"fees_paid":0,"total_pnl":3164015.996746,"realized_pnl":3164015.996746,"avg_buy_price":0.7301,"fees_refunded":0,"profit_factor":5.13161064369123,"avg_sell_price":0.8586,"max_win_streak":47,"max_loss_streak":2,"total_positions":123,"wallet_age_days":251,"active_positions":4,"positions_closed":120,"avg_hold_time_seconds":240907.925,"best_position_realized_pnl":818736.309837,"worst_position_realized_pnl":-184295.289336},"seven_day":{"roi":0,"wins":0,"losses":0,"trades":0,"volume":0,"win_rate":0,"fees_paid":0,"total_pnl":0,"realized_pnl":0,"avg_buy_price":null,"fees_refunded":0,"profit_factor":0,"avg_sell_price":null,"positions_closed":0},"thirty_day":{"roi":0,"wins":0,"losses":0,"trades":0,"volume":0,"win_rate":0,"fees_paid":0,"total_pnl":-431096.57930700015,"realized_pnl":-431096.57930700015,"avg_buy_price":null,"fees_refunded":0,"profit_factor":0,"avg_sell_price":null,"positions_closed":0}},"total_pnl":3164015.996746,"entry_edge":0.1285,"computed_at":1781322457,"last_trade_at":1768098770,"first_trade_at":1759595686,"trading_styles":{"is_degen":false,"is_whale":true,"is_contrarian":false,"primary_style":"WHALE","is_buy_and_hold":false,"is_market_maker":false,"is_value_hunter":false,"is_active_trader":true,"is_high_conviction":false},"unrealized_pnl":0}},"exampleRequest":{"input":{"body":{}}},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Uszj0UXaDxNWDvRKSSq_I","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns comprehensive trading performance metrics and style classification for a specific Polymarket wallet address, including PnL, ROI, win rate, trade volume, and position history.","exampleAgentPrompt":"Can you pull up the full trading performance stats for Polymarket wallet 0x17db3fcd93ba12d38382a0cade24b200185c5f6d — I want to see their all-time ROI, win rate, PnL, and how many positions they've held?","exampleUseCases":[{"title":"Evaluate a prediction market trader for copying","prompt":"I'm thinking about copy-trading this Polymarket wallet 0x8a2c9f1e4b7d3a6c5e9f1b2a3d4c5e6f. Can you pull their stats and tell me if they're consistently profitable? I want to see their win rate, profit factor, and how many winning streaks they've had."},{"title":"Rank traders for a leaderboard system","prompt":"I need to build a leaderboard of top Polymarket traders. Can you fetch the performance metrics for wallet 0x3f5a1b8e9c2d7a4f6e1c3a5b8d9e2f4a and compare their ROI, trade volume, and all-time PnL against our baseline?"},{"title":"Assess trader skill for risk management","prompt":"We're onboarding a new fund manager who claims to trade Polymarket. Can you check out their wallet 0x6b9d2e1f4a7c3e8b5a9f2c6d1e4a7b8c and give me their average hold time, max loss streak, and whether they've been trading consistently for at least a year?"}],"resultDescription":"Returns a JSON object containing the wallet address and a metrics object broken down by time period (1-day, 7-day, all-time). All-time metrics include: ROI, total PnL, realized PnL, trade count, volume, wins, losses, win rate, profit factor, avg buy/sell price, max win/loss streak, total and active positions, wallet age in days, average hold time, and best/worst single position PnL.","failureModes":["Invalid or malformed wallet address returns an error or empty metrics","Wallet address not found on Polymarket returns zero values across all metrics","Short time-window metrics (1-day, 7-day) return zeros if no recent activity","Network or upstream data provider outage returns HTTP 5xx","Insufficient payment (x402) causes request rejection with 402 status"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, pre-computed performance profile for a specific Polymarket trader — including style classification and multi-period breakdown — rather than raw position or order data. Ideal for evaluating trader quality, copy-trading analysis, or leaderboard ranking. Prefer over raw position endpoints when you need aggregated stats like profit factor, win streaks, or ROI in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:52:17.320Z","isFirstParty":false}