{"uid":"cap_nWPzZ22UasBX3YcJoHYzE","slug":"polymarket-whale-trade-monitor-47f73daa","name":"Polymarket Whale Trade Monitor","description":"Live whale-tracking on Polymarket: the latest large trades (default >= 5000 USD, tunable via min_usd) with wallet, side, outcome, size, price, USD value, market title/slug and tx hash, straight from Polymarket public trades data API. Built for prediction-market agents that track smart money before trading. No charge on service failure. Ed25519-signed. $0.15 USDC per call via x402 on Base. Free trial: 3 calls per wallet with header X-WALLET.","url":"https://api.hergertsynthora.com/v1/polymarket-whales","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"side":{"type":"string","description":"buy | sell | all (default all)"},"limit":{"type":"integer","description":"Max trades to return (1-100, default 25)"},"min_usd":{"type":"number","description":"Minimum trade size in USD (default 5000)"}}},"responseSchema":{"type":"json","example":{"ok":true,"niche":"polymarket_whales","result":{"count":20,"min_usd":10000,"total_usd":250000,"whale_trades":[{"tx":"0x...","side":"BUY","size":10000,"price":0.62,"market":"...","wallet":"0x...","outcome":"Yes","usd_value":6200,"market_slug":"...","timestamp_utc":"..."}],"unique_wallets":14,"top_markets_by_whale_usd":[]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B5DKNAH3sMrgPPsLinKKC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent large-size trades (whale trades) on Polymarket prediction markets, filterable by side and minimum USD size","exampleAgentPrompt":"Pull the top 50 whale trades on Polymarket right now — only buy-side trades worth at least $10,000 each — and tell me which markets and wallets are most active.","exampleUseCases":[{"title":"Spot whale conviction before a market moves","prompt":"Show me the 25 biggest buy-side trades on Polymarket in the last snapshot, with a minimum size of $5,000 — I want to see which markets the whales are piling into and what outcome they're betting on."},{"title":"Detect large exits from prediction markets","prompt":"Get me up to 30 sell-side whale trades on Polymarket, minimum $8,000 each, so I can see which markets big wallets are cashing out of right now."},{"title":"Scan all large trades for portfolio intelligence","prompt":"Fetch the top 100 trades from Polymarket regardless of side — both buys and sells — as long as they're at least $5,000, and summarize which wallets and markets have the most total whale volume."}],"resultDescription":"A JSON object containing the count of matched whale trades, total USD volume, minimum USD threshold used, an array of individual trades (each with transaction hash, side, size, price, market name, wallet address, outcome label, USD value, market slug, and UTC timestamp), the number of unique wallets involved, and a ranked list of top markets by whale USD volume.","failureModes":["Invalid 'side' value (not 'buy', 'sell', or 'all') returns a validation error","limit out of range (less than 1 or greater than 100) returns a parameter error","min_usd set to an unreasonably high value may return zero results","Network or upstream data source outage returns a non-ok response","Payment failure (insufficient USDC balance or x402 protocol error) blocks the call"],"whenToPreferThis":"Choose this endpoint when you need on-chain Polymarket trade data specifically filtered to large-size ('whale') activity, with wallet-level detail and market attribution. Prefer it over generic blockchain explorers when you want pre-filtered, structured whale intelligence without writing custom subgraph queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:33.083Z","isFirstParty":false}