{"uid":"cap_DLVTtYJA1YoOzpWfM-34i","slug":"predge-signals-consensus-by-category-65df4352","name":"Predge Signals Consensus by Category","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/signals/consensus/%7Bcategory%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"markets":[{"title":"Will the Fed cut rates in September?","category":"economics","platform":"polymarket","direction":"yes","condition_id":"0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39","net_flow_usd":143000,"smart_no_usd":41000,"smart_wallets":6,"smart_yes_usd":184000,"market_yes_price":0.62}],"category":"economics","smart_money":{"basis":"edge_lower_bound","definition":"smart money = a wallet whose luck-damped realized edge over the trailing window is positive (Wilson-95%-lower-bound(win rate) − avg entry price > min_edge_lower_bound), from RESOLVED outcomes — not the opaque scorer score","min_trades":10,"min_volume_usd":1000,"edge_window_days":30,"qualifying_wallets":474,"min_edge_lower_bound":0},"window_hours":24,"coverage_note":"category coverage is partial: markets without a category (historical tag-less tail) are excluded from category slices; fresh markets are categorized on ingest","insufficient_data":false}},"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_pZMm-Uxqeh-djQ1eESAqd","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 smart-money consensus signals for Polymarket prediction markets filtered by category, showing net flow, smart wallet direction, and current prices.","exampleAgentPrompt":"Pull the Predge smart-money consensus signals for the economics category on Polymarket — I want to see where whale wallets are flowing and what direction they're betting.","exampleUseCases":[{"title":"Fed rate decision trading edge","prompt":"What are smart whale wallets betting on for economics markets on Polymarket right now? I want net flow and the yes/no direction they're leaning."},{"title":"Politics market whale activity","prompt":"Show me the Predge consensus signals for politics prediction markets — which markets have the most smart money activity and what direction are they pointing?"},{"title":"Sports market smart money scan","prompt":"Scan the sports category on Predge for smart-wallet consensus — give me the markets with the biggest net flow from scored whale wallets and what price they're trading at."}],"resultDescription":"A JSON array of Polymarket markets in the requested category, each with title, platform, condition ID, yes/no direction, net flow in USD, smart-wallet yes and no USD totals, smart wallet count, and current yes price. Also includes smart money methodology metadata (edge window, qualifying wallets, minimum edge), window hours, and a coverage note about partial category coverage.","failureModes":["Unknown or unsupported category returns empty markets array or 404","Category with no recent smart-wallet activity returns markets list with zero net flow values","insufficient_data flag set to true if not enough resolved trades exist to score wallets","Rate limiting or payment failure returns 402 if USDC payment not provided","Fresh markets may be miscategorized or excluded until ingest catches up"],"whenToPreferThis":"Use this endpoint when you need real-time, category-level smart-money consensus from Polymarket — specifically when you want to identify where statistically edge-verified whale wallets are placing directional bets. Prefer this over generic Polymarket APIs when wallet quality scoring (Wilson lower-bound edge) and net flow aggregation by smart wallets matter. Best for trading signal research, market monitoring, and identifying informed trader activity within a specific domain category.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:29.474Z","isFirstParty":false}