{"uid":"cap_XycMfkdaQnrbZrOQtcBi6","slug":"predge-whale-intelligence-market-activity-by-condition-id-058312af","name":"Predge Whale Intelligence — Market Activity by Condition ID","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/whales/market/%7BconditionId%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"market":{"title":"Will the Fed cut rates in September?","status":"active","category":"economics","platform":"polymarket","yes_price":0.62,"condition_id":"0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39"},"trades":[{"side":"yes","price":0.62,"wallet":"0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8","tx_hash":"0x6a7de5…","category":"economics","platform":"polymarket","size_usd":25400,"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","wallet_win_rate_30d":0.67}],"summary":{"net_flow_usd":168000,"whale_trades":14,"no_volume_usd":122000,"unique_wallets":9,"yes_volume_usd":290000,"whale_volume_usd":412000},"window_days":7}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uOpaGlD0LLeCOVMgmEhEN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns whale trader activity, wallet scores, trade history, and volume summary for a specific Polymarket prediction market over the last 7 days","exampleAgentPrompt":"Pull up whale trading activity on the Polymarket market with condition ID 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — I want to see which big wallets are buying YES or NO, their wallet scores, and the overall volume breakdown.","exampleUseCases":[{"title":"Smart money flow before Fed decision","prompt":"For the Polymarket market on Fed rate cuts in September — condition ID 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — show me what whale wallets are doing, how much money is flowing to YES vs NO, and whether any high-score wallets are making big moves."},{"title":"Insider signal detection on election market","prompt":"I'm watching a Polymarket election market with condition ID 0xabc123... — can you pull the whale intelligence data and tell me if any wallets with scores above 75 and strong 30-day win rates are placing large trades on one side?"},{"title":"Automated market sentiment monitoring","prompt":"Every hour, check the Predge whale data for condition ID 0xdef456... and alert me if the net USD flow shifts by more than $50,000 or if a wallet with a score above 80 places a trade over $10,000."}],"resultDescription":"Returns a JSON object containing: the market title, status, category, and current YES price; an array of whale trades (wallet address, side, price, size in USD, wallet score 0–100, 30-day win rate, and block timestamp); and a summary of net flow in USD, total whale volume, YES/NO volume breakdown, and unique whale wallet count over the last 7 days.","failureModes":["Invalid or malformed conditionId returns 400 or empty result","Condition ID references a market not tracked by Predge returns empty trades array","Payment not attached or insufficient USDC returns 402 Payment Required","Rate limiting on free plan returns 429 Too Many Requests","Market is resolved/closed but data may still be returned with status 'resolved'"],"whenToPreferThis":"Use this endpoint when you need on-chain whale intelligence specifically for a known Polymarket market (by condition ID), including wallet scoring, win-rate attribution, and volume breakdowns. Prefer this over generic Polymarket APIs when you need heuristic insider detection, wallet reputation scoring, or smart-money flow signals rather than raw trade data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:42:44.969Z","isFirstParty":false}