{"uid":"cap_qS5DBERMJCfBbLKS_vrk1","slug":"predge-whale-wallet-trade-history-api-fb685803","name":"Predge Whale Wallet Trade History API","description":"Polymarket whale trades and smart-money signals from the Predge tracking pipeline, sold per-call over the x402 payment protocol. No API keys, no accounts.","url":"https://x402-api-production-266e.up.railway.app/v1/wallets/%7Baddress%7D/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":{"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,"decided_trades":17,"modeled_pnl_usd":4820.5},"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_BKE0xsIqxjOi3KH5ffRjr","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 whale wallet address, including a running win-rate and modeled P&L, over a configurable lookback window.","exampleAgentPrompt":"Pull up the full trade history for Polymarket whale wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8 over the last 90 days — I want to see their win rate, modeled P&L, and every market they've traded.","exampleUseCases":[{"title":"Vetting a whale before copying trades","prompt":"Before I mirror this trader, can you pull the 30-day Polymarket trade history for wallet 0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8? I want to see their win rate, wallet score, and how much they've modeled-profited."},{"title":"Long-term whale performance audit","prompt":"Give me the all-time Polymarket trade history for wallet 0xabc123…, I want to know their total trades, decided trades, wins, and cumulative modeled P&L across everything they've ever done."},{"title":"Monitoring a known smart-money address","prompt":"Check the last 90 days of Polymarket activity for this wallet — 0x4f9a12… — and tell me which markets they bet on, what side they took, what price they entered at, and whether they won."}],"resultDescription":"A JSON object containing a list of individual trades (with fields: wallet, market title, market slug, condition ID, side, entry price, size in USD, resolution, whether the trade won, modeled P&L per trade, running modeled P&L, and 30-day win rate), plus a summary with total trade count, decided trades, wins, overall win rate, and aggregate modeled P&L. Also includes the queried address and window. A note clarifies that modeled_pnl_usd is an estimate, not settled P&L.","failureModes":["Invalid or non-existent wallet address returns empty trades array or 404","Unrecognized window value (not 30d/90d/all) may return 400 or default behavior","Payment not fulfilled via x402 protocol returns 402 Payment Required","Address with no Polymarket activity returns empty summary and trades list","Network or Railway infrastructure downtime returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need a comprehensive historical view of a single whale wallet's Polymarket activity — including per-trade details, running P&L, and a wallet quality score — rather than a top-level leaderboard or market-wide whale activity. Prefer this over the market-specific whale endpoint when the user is investigating a known wallet address rather than a specific market. Best when you want multi-market aggregated performance across a configurable time window (30d, 90d, or all-time) for one address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:31.508Z","isFirstParty":false}