{"uid":"cap_N5uZXzWeTkpLKKjkoFm3I","slug":"predge-whale-data-wallet-trade-history-72892b5e","name":"Predge Whale Data – Wallet Trade History","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://x402-api-production-266e.up.railway.app/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_dibwSEXhGIpIX_oz7Wch5","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 Polymarket trades for a specific wallet address with running win-rate and modeled PnL curve computed from resolved markets","exampleAgentPrompt":"Pull the last 90 days of Polymarket trade history for wallet 0x3a4e...f9c2 on Predge — I want to see their win rate and modeled PnL curve across resolved markets.","exampleUseCases":null,"resultDescription":"Returns up to 500 most-recent trades (capped, but summary computed over all trades in window) including market info, side, size_usd, entry price, won status (null if unresolved), and modeled_pnl_usd (null if unresolved). Also includes summary object with win_rate (verified), modeled PnL curve, trades_returned, and trades_capped flag. 15-minute data delay. 404 returned (not billed) for wallets not in Predge dataset.","failureModes":["404 if wallet address is not known to Predge dataset (not charged)","Invalid 0x address format returns error","Window parameter value outside enum (30d|90d|all) causes bad request","Rate limiting or payment failure returns 402","Trades array capped at 500 but summary still covers full window — agent must use summary fields for totals, not array length"],"whenToPreferThis":"Use this endpoint when you need the full historical trade record and running performance metrics (win rate, modeled PnL) for a specific Polymarket proxy wallet. Prefer this over the wallet profile endpoint when you need the raw trades array for further analysis, or over the leaderboard endpoint when you already know the wallet address. Note that modeled_pnl_usd is an estimate (assumes $1 binary payout per winning share) and should not be treated as realized/settled P&L.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:36.494Z","isFirstParty":false}