{"uid":"cap_k-ZoDDUvaNylHvXiO4qce","slug":"blockrun-ai-90bd9834","name":"BlockRun.AI Polymarket Wallet Activity","description":"Returns wallet data and activity for a specified Polymarket address.","url":"https://blockrun.ai/api/v1/pm/polymarket/wallet/0x16f91db2592924cfed6e03b7e5cb5bb1e32299e3","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":"null"},"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":"null"},"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":"0x16f91db2592924cfed6e03b7e5cb5bb1e32299e3","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.8037812894897408,"wins":9,"losses":1,"trades":6471,"volume":5035610.021899,"win_rate":0.9,"fees_paid":0,"total_pnl":4049817.1930255513,"realized_pnl":4047528.123303,"avg_buy_price":0.5583,"fees_refunded":0,"profit_factor":29.204873580121937,"avg_sell_price":null,"max_win_streak":6,"max_loss_streak":1,"total_positions":11,"wallet_age_days":582,"active_positions":1,"positions_closed":10,"avg_hold_time_seconds":1155981.5,"best_position_realized_pnl":2132244.478698,"worst_position_realized_pnl":-143504.56533},"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":2289.069722551387,"realized_pnl":0,"avg_buy_price":null,"fees_refunded":0,"profit_factor":0,"avg_sell_price":null,"positions_closed":0}},"total_pnl":4049817.1930255513,"entry_edge":null,"computed_at":1780035415,"last_trade_at":1731428475,"first_trade_at":1729760447,"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":false,"is_active_trader":true,"is_high_conviction":false},"unrealized_pnl":2289.069722551387}},"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_oPG1Pa8N-vFO5ITSLFn_g","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 wallet data, trading metrics, and activity history for a specified Polymarket prediction market wallet address.","exampleAgentPrompt":"Can you pull up the all-time Polymarket trading stats for wallet 0x16f91db2592924cfed6e03b7e5cb5bb1e32299e3 — I want to see their ROI, win rate, total PnL, and trade history?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the wallet address and nested metrics broken down by time period (1-day, 7-day, all-time), including ROI, wins, losses, trade count, volume, win rate, fees paid, total PnL, realized PnL, average buy/sell prices, profit factor, max win/loss streaks, total positions, active positions, positions closed, wallet age in days, average hold time in seconds, and best/worst position realized PnL.","failureModes":["Invalid or malformed wallet address returns an error or empty data","Wallet address not found on Polymarket returns zero metrics","Payment not provided or insufficient USDC triggers 402 Payment Required","Rate limiting or service unavailability returns 5xx error","Truncated or partial response if wallet has extremely large trade history"],"whenToPreferThis":"Use this endpoint when you need comprehensive Polymarket-specific trading performance analytics for a single wallet address, including time-windowed breakdowns (1-day, 7-day, all-time), PnL, win rates, and position history. Prefer this over generic on-chain data providers when the specific context is Polymarket prediction market activity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:00.847Z","isFirstParty":false}