{"uid":"cap_83qrIbSMEO01kzSjOOGXA","slug":"predge-whale-data-single-market-smart-money-verdict-c42bf11b","name":"Predge Whale Data — Single-Market Smart-Money Verdict","description":"Single-market smart-money VERDICT for one Polymarket market (path param: conditionId, 0x… Polymarket condition id) — the \"should you trust this move?\" decision, built to be looped once per market per cycle. This is /v1/signals/consensus scoped to one market: SAME edge-based smart-money population (a wallet qualifies when its luck-damped realized edge over the last 30d — Wilson-95%-lower-bound(live win rate) − avg entry price — exceeds 0, from RESOLVED outcomes, with the same >= 10 trades / >= $1,000 floors), and the SAME direction rule (>= 55% of smart volume / >= 10% imbalance => \"yes\"/\"no\", else \"split\"). Returns market metadata (title, category, yes_price, status, and resolution/resolved_at when settled), the edge-proven smart-money read for whale trades (>= $10,000) in the last 24h — distinct smart wallets, YES/NO split, net flow (USD), direction verdict — plus total-vs-smart whale volume and a plain confidence (none|low|medium|high) + basis an agent can act on. Honest degradation via {\"insufficient_data\": true, \"reason\": ...} when too few smart wallets have touched the market. 404 (not charged) for a condition id unknown to the Predge dataset. 15 min delay.","url":"https://api.predge.io/v1/signals/market/:conditionId","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.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_Suf5_Y4GQeGOA26eojkaJ","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 an edge-based smart-money directional verdict (yes/no/split) plus whale trade breakdown and confidence rating for a single Polymarket prediction market identified by conditionId.","exampleAgentPrompt":"Check the Predge smart-money verdict for Polymarket condition 0x3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b — are edge-proven whales leaning YES or NO, and how confident is the signal?","exampleUseCases":[{"title":"Pre-trade smart-money gut-check","prompt":"Before I put money on this Polymarket market, pull the Predge whale verdict for condition 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d — I want to know if edge-proven whales are leaning YES or NO and what the confidence level is."},{"title":"Automated trading bot signal gate","prompt":"My bot is about to enter a YES position on Polymarket condition 0xabcdef1234567890abcdef1234567890abcdef12 — first check Predge to see if smart-money whale flow in the last 24 hours supports that direction with at least medium confidence before executing."},{"title":"Post-resolution smart-money validation","prompt":"That Polymarket market with condition 0x9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c just resolved — what did Predge's smart-money verdict say going in, and did the whale direction call match the outcome?"}],"resultDescription":"Returns a JSON object containing: market metadata (title, category, current yes_price, status, and resolution/resolved_at if settled); a smart-money whale signal block covering the last 24 hours of trades >= $10,000 (distinct qualifying smart wallets, YES vs NO volume split, net USD flow, and a direction verdict of yes/no/split); total vs smart whale volume figures; and a plain-language confidence level (none/low/medium/high) plus a human-readable basis string explaining why that confidence was assigned. Degrades honestly when data is insufficient.","failureModes":["Invalid or malformed conditionId (not a valid 0x Polymarket condition hash) returns an error","Market not found on Polymarket returns empty or 404-style response","Insufficient whale activity in the last 24h results in confidence=none and direction=split","Smart-money population too small (fewer than required qualifying wallets) causes low or none confidence","Payment not fulfilled (x402 protocol) results in 402 Payment Required","Rate limiting if called too rapidly in a loop"],"whenToPreferThis":"Choose this endpoint when you need a single-market, per-cycle smart-money verdict for a specific Polymarket condition and want an actionable yes/no/split direction with honest confidence scoring. It is purpose-built for agents that iterate over a list of markets one at a time. Prefer the consensus endpoint if you need cross-market aggregate signals. Prefer this over generic Polymarket data sources when you want edge-filtered whale intelligence (luck-damped, Wilson-bound edge criterion) rather than raw volume or price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:54:24.482Z","isFirstParty":false}