{"uid":"cap_T5WluXrRpbkx4F_jcCIXf","slug":"predge-whale-data-wallet-trade-history-win-rate-979fd737","name":"Predge Whale Data — Wallet Trade History & Win-Rate","description":"Historical trades for one wallet (path param: 0x… proxy-wallet address) plus a running win-rate & MODELED-PnL curve, computed ONLY from RESOLVED markets (modeled_pnl_usd is a MODELED estimate, NOT realized/settled P&L — it assumes a $1 binary payout per winning share, shares = size_usd ÷ entry price; not a substitute for on-chain settled P&L). Unresolved trades still appear (won: null, modeled_pnl_usd: null) but do not move the curve. Query param: window (30d|90d|all, default 30d — \"all\" is UNBOUNDED, window_days: null). The trades array is capped at 500 most-recent-first, but summary is computed over EVERY trade in the window (see summary.trades_returned / trades_capped), so the total matches this wallet's profile. 15 min delay. 404 (not charged) for wallets unknown to the Predge dataset. outcome_verified: {win_rate: true, pnl: false}.","url":"https://api.predge.io/v1/wallets/:address/history","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","properties":{"window":{"enum":["30d","90d","all"],"type":"string","description":"Lookback window (default 30d)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_y9XXm6yahzLl-Xucx06Ad","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns historical trades, running win-rate, and modeled PnL curve for a specific Polymarket proxy-wallet address over a configurable lookback window","exampleAgentPrompt":"Pull up the last 90 days of trade history and win-rate for Polymarket wallet 0x1234abcd… on Predge — I want to see how this whale has been performing and what their modeled PnL curve looks like.","exampleUseCases":[{"title":"Vetting a whale wallet before copying trades","prompt":"Before I follow this trader, can you pull up the 90-day trade history and win-rate for Polymarket wallet 0xAbCd1234… on Predge so I can see if they're actually profitable?"},{"title":"Monitoring a known insider-watch wallet","prompt":"Check the full all-time trade history on Predge for wallet 0xDeadBeef… — I want to see every resolved trade, their overall win-rate, and the modeled PnL curve since they first appeared in the dataset."},{"title":"Evaluating recent 30-day performance of a trader","prompt":"What does the last 30 days look like for Polymarket wallet 0x9999aaaa… on Predge? Give me their recent trades, how many they won, and what the modeled PnL curve shows."}],"resultDescription":"Returns a trades array (up to 500 most-recent-first) with individual trade details including won status and modeled_pnl_usd (null for unresolved), plus a summary object containing win_rate (verified), total trades in window, trades_returned, trades_capped flag, and the cumulative modeled PnL curve computed only over resolved markets. 15-minute data delay. Returns 404 (not billed) if the wallet is not in the Predge dataset.","failureModes":["404 Not Found — wallet address is unknown to Predge dataset (not charged)","Invalid wallet address format — non-0x or malformed proxy-wallet address","Unresolved trades have won: null and modeled_pnl_usd: null and do not contribute to the PnL curve","modeled_pnl_usd is a model estimate (assumes $1 binary payout per winning share) and is NOT verified realized P&L","Trades array capped at 500 but summary statistics cover the full window — agent must check trades_capped flag","15-minute data delay means very recent trades may not appear","window=all is unbounded (window_days: null) and may return very large summary ranges for highly active wallets"],"whenToPreferThis":"Choose this endpoint when you need historical trade-level detail and win-rate analytics for a specific Polymarket wallet address. It is the right choice for due-diligence on whale traders, copy-trading evaluation, or tracking a known wallet's performance over time. Prefer this over generic on-chain data sources when you want Predge's curated dataset with pre-computed win-rate and modeled PnL curve. Use the 30d window for recent performance checks, 90d for medium-term, and 'all' for lifetime track record. Note the PnL is modeled, not settled — do not use it as a substitute for verified on-chain realized P&L.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:53:22.085Z","isFirstParty":false}