{"uid":"cap_maqIDWmbmDonjxt-CVtWC","slug":"predge-wallet-trade-history-df03b4d5","name":"Predge Wallet Trade History","description":"Real-time alerts on whale traders on Polymarket. Heuristic Insider Watch, wallet scoring 0–100, Bloomberg-style web terminal. Free plan included.","url":"https://api.predge.io/v1/wallets/%7Baddress%7D/history","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"note":"modeled_pnl_usd is a MODELED estimate ($1 binary payout per winning share, shares = size_usd ÷ entry price, over resolved markets), NOT realized/settled P&L.","trades":[{"won":true,"side":"yes","price":0.62,"wallet":"0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8","tx_hash":"0x6a7de5…","category":"economics","platform":"polymarket","size_usd":25400,"resolution":"yes","market_slug":"fed-rate-cut-september","condition_id":"0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39","market_title":"Will the Fed cut rates in September?","wallet_score":81,"block_timestamp":"2026-07-17T09:41:02.000Z","modeled_pnl_usd":15575.9,"wallet_win_rate_30d":0.67,"running_modeled_pnl_usd":4820.5}],"window":"30d","address":"0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8","summary":{"wins":12,"win_rate":0.71,"trades_count":24,"trades_capped":false,"decided_trades":17,"modeled_pnl_usd":4820.5,"trades_returned":24},"window_days":30,"outcome_verified":{"pnl":false,"win_rate":true}}},"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_NlBVC3UIVSifgzet6THxV","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":"Retrieves a scored wallet's full trade history on Polymarket with modeled PnL, win rate, and per-trade metadata over a configurable lookback window","exampleAgentPrompt":"Pull up the last 30 days of trade history for Polymarket wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 — I want to see the wallet score, win rate, and modeled PnL on each resolved market.","exampleUseCases":[{"title":"Vetting a whale before copy-trading","prompt":"Before I mirror this wallet's positions, can you pull their 90-day Predge history for 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 and tell me their wallet score, win rate, and total modeled PnL?"},{"title":"Researching insider activity on a market","prompt":"I want to know which trades wallet 0x3fa12b88c9d471e8e3b2f91c5d4a7e6f1b0c2a4d made on Polymarket over all time — show me their win rate and whether any trades look like insider signals."},{"title":"Due diligence on an unfamiliar address","prompt":"Someone shared a Polymarket wallet address 0x1c9d3f7a2b5e4c8d6f0a3b7e9c2d1f4a8b5e3c7 with me — can you look them up on Predge and give me a summary of their trading performance and wallet score over the last 30 days?"}],"resultDescription":"Returns a JSON object containing a list of trades with fields including market title, side (yes/no), entry price, size in USD, resolution outcome, whether the trade won, modeled PnL, running modeled PnL, wallet score, and wallet win rate. Also includes a summary block with total trades count, wins, win rate, total modeled PnL, and a flag indicating whether the full trade list was capped. Outcome verification flags indicate which metrics (win rate vs PnL) are verified vs modeled estimates.","failureModes":["Invalid or malformed wallet address returns a 400 or empty result","Unknown wallet with no Polymarket history returns empty trades array","Invalid window parameter value outside enum causes validation error","Rate limit exceeded or payment failure returns 402/429","Modeled PnL is an estimate (not settled P&L) and may not reflect actual realized gains"],"whenToPreferThis":"Use this endpoint when you need granular per-trade history and performance scoring for a specific Polymarket wallet address. Prefer this over general blockchain explorers when you need prediction-market-specific context like market titles, resolution outcomes, win rates, and the proprietary 0-100 wallet score that signals smart money or insider activity. Best when researching whether to copy-trade a whale or assess the credibility of a wallet flagged in an alert.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:50:20.823Z","isFirstParty":false}