{"uid":"cap_oE4UitB_jTvHBQvoGSW-y","slug":"predge-whale-data-category-consensus-e8758984","name":"Predge Whale Data — Category Consensus","description":"Smart-money consensus for ONE market category (path param, e.g. economics, politics, sports — case-insensitive). Same EDGE-based smart-money definition as /v1/signals/consensus (luck-damped realized edge over the last 30d > 0, NOT the scorer score), scoped: active Polymarket markets of that category with whale trades (>= $10,000) in the last 24h from edge-positive wallets; YES/NO smart volume, net flow, direction verdict. Category coverage is partial — markets without a category are excluded (see coverage_note in the response). Unknown category => 404 (not charged) listing known_categories. Honest degradation via {\"insufficient_data\": true, \"reason\": ...}. 15 min delay.","url":"https://api.predge.io/v1/signals/consensus/:category","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":{}}},"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_bFXjWpv4tvjLcCJOrMG8t","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 (YES/NO volume, net flow, direction verdict) for active Polymarket prediction markets in a specified category, filtered to whale trades ≥$10,000 from edge-positive wallets in the last 24h.","exampleAgentPrompt":"What's the smart-money whale consensus on Predge for the politics category right now — are edge-positive whales leaning YES or NO, and what's the net flow?","exampleUseCases":[{"title":"Pre-election politics market check","prompt":"Check Predge for the smart-money whale consensus in the politics category — I want to know whether big edge-positive traders are buying YES or NO and what the net flow looks like today."},{"title":"Economics market whale signal scan","prompt":"Pull the Predge whale consensus for the economics category and tell me which direction smart money is flowing on active Polymarket markets right now."},{"title":"Sports event betting intelligence","prompt":"I'm looking at Polymarket sports markets — can you grab the Predge whale data for the sports category and tell me if there's a clear direction verdict from edge-positive whales?"}],"resultDescription":"Returns per-market smart-money data for the requested category: YES and NO smart volume from whale trades ≥$10,000 by edge-positive wallets (luck-damped realized edge >0 over 30d), net flow, and an overall direction verdict. Includes a coverage_note about partial category coverage. If data is insufficient, returns {\"insufficient_data\": true, \"reason\": ...}. If the category is unknown, returns a 404 with a known_categories list (not charged). Data has a 15-minute delay.","failureModes":["Unknown category name returns 404 with known_categories list (no charge)","Insufficient whale activity in category returns {\"insufficient_data\": true, \"reason\": ...}","Markets without assigned categories are excluded, reducing coverage","15-minute data delay may miss very recent whale trades","Partial category coverage means some active markets may not appear"],"whenToPreferThis":"Use this endpoint when you need category-scoped smart-money signals from Polymarket specifically — i.e. you want to know what edge-proven whale wallets are doing in a named market vertical (politics, economics, sports, etc.) rather than across all markets. Prefer this over the global consensus endpoint when you need to narrow your analysis to one domain. Best for agents building sector-specific trading signals or monitoring a particular prediction market category for whale conviction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:40:58.544Z","isFirstParty":false}