Whale Data Mcp

Free. Returns the Predge API description, network, payTo, and every endpoint with its price and what it returns. Call this first to see what's available before paying.

Takes no parameters.

PAID (~$0.005). Latest Polymarket whale trades ≥$10k notional (15-min delay): market, side, size, price, wallet address + Predge wallet score. Param: limit (1-100, default 50).

PAID (~$0.01). 7-day whale activity + aggregates (volume, YES/NO split, net flow, unique wallets) for one Polymarket market. Param: condition_id.

PAID (~$0.02). 24h digest: top markets by whale volume, net flow, largest single bets, totals.

Takes no parameters.

PAID (~$0.01). Top wallets over resolved markets, ranked by edge (win rate vs. entry price), not raw win rate. Params: window (7d|30d, default 30d), limit (1-100, default 50).

PAID (~$0.01). One wallet's profile: Predge score, win rates (7d/30d), favorite categories, last 20 trades (15-min delay). Param: address (0x…).

PAID (~$0.005). Largest YES-price moves across active markets (from trade prints). Param: window (1h|6h|24h, default 6h).

PAID (~$0.03, premium). Per active market with whale activity in 24h: net flow of smart-money wallets (score > 70), YES/NO volume, and a direction verdict.

Takes no parameters.

PAID (~$0.02). Resolved-outcome ATTESTATION for one Polymarket market: the SETTLED truth straight off the market row — resolved (bool), resolution (yes|no|null), resolved_at, and outcome_verified:{resolution:true}. Pure outcome-verified data — no modeled estimate anywhere. Optional side (yes|no): adds queried_side and correct (true iff side matches the resolved outcome) — use it to VERIFY whether a past signal, call, or advertised win-rate was actually right. Unknown/unresolvable market returns null and is NOT charged. Params: condition_id, side.

PAID (~$0.02). Ed25519-SIGNED settled game outcome for one finished match — winner, final score, completed(bool), teams, scheduled time — sourced from ESPN and signed with Predge's published key, so it VERIFIES OFFLINE (no trust in this API): re-check the signature against the pubkey at data.predge.io/.well-known/predge-attest.json. Use it to settle bets, prove a track record, or ground a wager on a tamper-evident result. Optional winner (team abbreviation e.g. 'LAL'): adds queried_winner and correct (true iff it matches the settled winner). Unknown league or unfinished/unknown event returns null and is NOT charged. Leagues: nba, wnba, nfl, college-football, mlb, nhl, mls, epl, champions-league, laliga. Params: league, event_id (provider event id), winner.

PAID (~$0.005). Top-20 largest single trades across all Polymarket markets in the window (market, side, size, price, wallet + score). Param: window (24h|7d, default 24h).

PAID (~$0.01). The 24h whale digest scoped to one market category (e.g. politics, economics, sports). Unknown category → 404 (not charged) with the known_categories list. Param: category.

PAID (~$0.02). Edge-verified smart-money consensus (net flow + direction) scoped to one category. Unknown category → 404 (not charged) with known_categories. Param: category.

PAID (~$0.01). Single-market smart-money VERDICT — the "should you trust this move?" decision for one market: edge-verified smart flow, direction and confidence. Param: condition_id.

PAID (~$0.02). One wallet's trade history with a running win-rate and modeled-PnL curve. Params: address (0x…), window (30d|90d|all, default 30d).

PAID (~$0.02). Side-by-side comparison of 2-10 wallets (scores, win rates, modeled PnL) plus their market overlap. Param: addresses (2-10 0x… addresses).

PAID (~$0.01). Price/volume history for one Polymarket market in daily buckets (price normalized to the YES side) plus recent prints. Params: condition_id, window (7d|30d|all, default 30d).

FREE, no key or payment. Live UMA settlement risk for one Polymarket market, read from UMA's Optimistic Oracle and Polymarket's UMA CTF adapter on Polygon: uma_state, current proposal and challenge window, every dispute, whether it went to a UMA vote, bulletin-board updates, on-chain resolution, risk_level (ok|watch|caution|resolved) with a one-line recommendation, plus the segment_dispute_rate statistic and a settlement_estimate_available flag. The settlement_estimate itself is NOT in this free record: it is sold by predge_settlement_estimate (GET /v1/settlement-risk/:market/estimate, ~$0.02). The record is ed25519-signed (predge-attest-v1); this tool re-checks the signature, content hash and signer key and returns the result under `verification`. A dispute blocks a proposal; it does not by itself change the outcome. 404 unknown_market and 422 unsupported_* are NOT 'no risk' answers. Rate limit 60/min per IP. Param: market (condition id 0x+64 hex, numeric market id, or slug).

PAID (~$0.02 via x402). The same signed live UMA settlement-risk record as the free predge_settlement_risk tool, WITH settlement_estimate: a statistic computed from 2026 Polymarket UMA disputes (market price before the first dispute + market type). A statistic, not advice. GET /v1/settlement-risk/:market/estimate. The tool re-checks the ed25519 signature and returns `{ verification, record }`. Call predge_settlement_risk first (free) and check settlement_estimate_available before paying. With PREDGE_KEY set to a pilot key from https://predge.io/start it is free for 30 days. Param: market (condition id 0x+64 hex, numeric market id, or slug).

FREE. Checks a Predge signed record (predge-attest-v1) without trusting the API: payload re-canonicalises to `canonical`, sha256(canonical) == content_hash, ed25519 signature over canonical, envelope_signature when present, and that public_key is an active key in api.predge.io/.well-known/predge-keys.json (the only network call; it is cached). Works on responses from predge_settlement_risk, predge_attest, predge_sports_attest, predge_verdict, predge_get_verdict, or a bare `attestation` envelope. Param: record (the JSON, as a string).

PAID: $0.05 when payment.amount_usd < 1 (POST /v1/verdicts), $0.50 when >= 1 (POST /v1/verdicts/large); the tool picks the route. FREE with PREDGE_KEY set to a pilot key (https://predge.io/start) inside its 30-day window. Send what was promised (job: endpoint, expected content type, JSON Schema, required fields, max latency, expected sha256), the delivery evidence (status, headers, body or body_sha256, timing) and the payment reference (amount_usd, tx_hash, network, payer, payee), optionally the buyer and provider agent identities (id, version, operator, authorization_ref). Returns an ed25519-signed verdict (delivered | not_delivered | inconclusive), per-check results, reason codes and a refund RECOMMENDATION (the merchant honours it; nothing is refunded automatically). Deterministic checks, no LLM. The tool re-checks the signature and returns `{ verification, record }`; re-read later for free with predge_get_verdict. Paying the $0.50 tier over x402 needs MAX_PRICE_USD >= 0.5. Without a key or buyer wallet the result is the API's 402 explanation (price and how to pay).

FREE, no payment. GET /v1/verdicts/:id: the stored signed verdict issued by predge_verdict, byte-identical in content. The tool re-checks the ed25519 signature and returns `{ verification, record }`. 404 verdict_not_found for an unknown id. Param: id (vrd_ + 24 characters).

FREE for a key holder, counts as one call against the key's daily quota. GET /v1/verdicts/report: the verdicts requested with PREDGE_KEY in one UTC month (optionally one merchant_id): counts by outcome, refund recommendations (count, total USD), top reason codes, median/p95 time to verdict, verdict ids with verify URLs (paginated, next_cursor), a sample and the methodology. Signed; the tool re-checks the signature. Params: month (YYYY-MM), merchant_id, limit (1-1000, default 100), cursor, sample (0-20, default 5).

FREE. GET /v1/me with PREDGE_KEY: the key's plan, daily quota and use, and when the pilot window ends.

Takes no parameters.

FREE with a Desk key in PREDGE_KEY (https://predge.io/desk, 14-day trial). GET /v1/desk/config: the Polymarket wallets the Desk watches, where settlement alerts go (webhook, Telegram) and the plan status (trial, paid_until). Read only.

Takes no parameters.