{"uid":"cap_P_FVhyfNVpIGMlP3OXteX","slug":"blockrun-ai-0ba70f66","name":"BlockRun.AI Polymarket Wallet Performance Analytics","description":"Returns detailed Polymarket wallet performance analytics for a given wallet address, including realized and unrealized PnL, volume, ROI, trade counts, win/loss metrics, trading style, and account age. Useful for evaluating a trader’s activity and results.","url":"https://blockrun.ai/api/v1/pm/polymarket/wallet/0xdb27bf2ac5d428a9c63dbc914611036855a6c56e?utm_source=zero.xyz","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":"0xdb27bf2ac5d428a9c63dbc914611036855a6c56e","metrics":{"one_day":{"roi":0,"wins":0,"losses":0,"trades":0,"volume":0,"win_rate":0,"fees_paid":0,"total_pnl":3313.386524864938,"realized_pnl":0,"avg_buy_price":null,"fees_refunded":0,"profit_factor":0,"avg_sell_price":null,"positions_closed":0},"all_time":{"roi":0.0389355317424939,"wins":805,"losses":908,"trades":290673,"volume":97118923.683308,"win_rate":0.469935785172213,"fees_paid":655417.830159,"total_pnl":3455463.3132833345,"realized_pnl":3630308.921424,"avg_buy_price":0.4874,"fees_refunded":0,"profit_factor":1.08172320531532,"avg_sell_price":0.534,"max_win_streak":102,"max_loss_streak":11,"total_positions":1731,"wallet_age_days":379,"active_positions":29,"positions_closed":1723,"avg_hold_time_seconds":337626.139411765,"best_position_realized_pnl":1328633.247036,"worst_position_realized_pnl":-727198.111189},"seven_day":{"roi":0,"wins":0,"losses":0,"trades":0,"volume":0,"win_rate":0,"fees_paid":0,"total_pnl":134333.84001795202,"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":-42086267.65285167,"realized_pnl":-42566839.87487,"avg_buy_price":null,"fees_refunded":0,"profit_factor":0,"avg_sell_price":null,"positions_closed":0}},"total_pnl":3455463.3132833345,"entry_edge":0.0466,"computed_at":1781322457,"last_trade_at":1778608408,"first_trade_at":1748551963,"trading_styles":{"is_degen":false,"is_whale":false,"is_contrarian":false,"primary_style":"ACTIVE_TRADER","is_buy_and_hold":false,"is_market_maker":false,"is_value_hunter":true,"is_active_trader":true,"is_high_conviction":false},"unrealized_pnl":480572.22201833443}},"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_phU-lxIJbbzBo2kpPDvfy","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 Polymarket trading performance analytics for a given wallet address, including PnL, ROI, win/loss metrics, trade counts, volume, and account age across multiple time windows.","exampleAgentPrompt":"Pull up the full Polymarket trading stats for wallet 0xdb27bf2ac5d428a9c63dbc914611036855a6c56e — I want to see their all-time ROI, win rate, total PnL, and how long they've been trading.","exampleUseCases":null,"resultDescription":"A structured JSON object containing the wallet address and time-bucketed performance metrics (1-day, 7-day, all-time) including: realized and unrealized PnL, total PnL, ROI, volume, trade count, wins, losses, win rate, fees paid, profit factor, average buy/sell prices, max win/loss streaks, total and active positions, positions closed, average hold time in seconds, wallet age in days, and best/worst single position PnL.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Wallet has no Polymarket activity — returns zero or null metrics","Upstream Polymarket data unavailable causing stale or missing time-bucket data","Rate limiting or payment failure (x402) if USDC balance is insufficient","Network timeout for wallets with very high trade counts"],"whenToPreferThis":"Use this endpoint when you need deep, time-windowed trading performance analytics for a specific Polymarket wallet — including PnL, ROI, win rates, profit factor, and hold time statistics. Prefer this over simpler wallet lookup endpoints when the goal is trader evaluation, leaderboard comparison, or due diligence on a prediction market participant.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:50:03.850Z","isFirstParty":false,"canonicalSlug":"blockrun-ai-0ba70f66"}