{"uid":"cap_e22znPTbXny80_uA6cXFh","slug":"predge-whale-data-api-market-trade-history-5dece3d5","name":"Predge Whale Data API – Market Trade History","description":"Polymarket whale trades and smart-money signals from the Predge tracking pipeline, sold per-call over the x402 payment protocol. No API keys, no accounts.","url":"https://x402-api-production-266e.up.railway.app/v1/markets/%7BconditionId%7D/history","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":{"window":{"enum":["7d","30d","all"],"type":"string","description":"Lookback window (default 30d)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"market":{"title":"Will the Fed cut rates in September?","status":"active","category":"economics","platform":"polymarket","yes_price":0.62,"resolution":null,"resolved_at":null,"condition_id":"0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39"},"trades":[{"side":"yes","price":0.62,"wallet":"0x8dab6cf42d7e4d1cd6cca897b9e12a8cbe6d69e8","tx_hash":"0x6a7de5…","category":"economics","platform":"polymarket","size_usd":25400,"market_slug":"fed-rate-cut-september","condition_id":"0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39","market_title":"Will the Fed cut rates in September?","wallet_score":81,"block_timestamp":"2026-07-17T09:41:02.000Z","wallet_win_rate_30d":0.67}],"window":"30d","buckets":[{"trades":9,"avg_price":0.58,"volume_usd":96400,"bucket_start":"2026-07-17T00:00:00.000Z","whale_volume_usd":71000}],"window_days":30,"outcome_verified":{"flow":false,"resolution":true}}},"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_buHdvEUr8s23lWl4HpsqV","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 historical whale trades, smart-money signals, price/volume buckets, and outcome verification for a single Polymarket market identified by condition ID.","exampleAgentPrompt":"Pull the last 30 days of whale trade history on Polymarket for condition ID 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — I want to see which smart-money wallets have been buying or selling, their wallet scores, win rates, and the daily volume buckets.","exampleUseCases":[{"title":"Whale sentiment check before trading","prompt":"Before I take a position, check the last 30 days of whale trades on Polymarket for condition 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 — are high-score wallets piling in on yes or no, and what does the volume trend look like?"},{"title":"Smart-money signal monitoring for agent","prompt":"Every morning, fetch the 7-day whale trade history from Predge for Polymarket condition 0xabc123…and alert me if any wallet with a score above 75 and a 30-day win rate above 60% has made a trade larger than $10,000 USD."},{"title":"Research report on a political prediction market","prompt":"I'm writing a report on the Fed rate cut market on Polymarket — grab all available whale trade history for condition 0x178a746e2b342c25b1d78d0f0d0ea77157c9b6d40b2e97ffbf827cd7f9994c39 and summarize the biggest trades, the wallets involved, their win rates, and whether the outcome has been verified."}],"resultDescription":"Returns a JSON object with market metadata (title, status, category, yes_price, resolution), a list of individual whale trades (side, price, size_usd, wallet address, wallet_score, wallet_win_rate_30d, block_timestamp, tx_hash), daily/bucketed volume aggregates (trades count, avg_price, volume_usd, whale_volume_usd per bucket), the requested window, and an outcome_verified object indicating whether flow and resolution signals are confirmed.","failureModes":["Invalid or malformed conditionId path param returns an error or empty result","Unknown conditionId with no tracked trades returns empty trades array","Payment not processed via x402 protocol results in 402 Payment Required response","Invalid window enum value (anything other than 7d, 30d, all) may return error or default to 30d","Railway deployment downtime causes 502/503 response","Rate limiting or stale data if tracking pipeline has a delay"],"whenToPreferThis":"Choose this endpoint when you need granular historical whale trade records for a specific Polymarket market, including individual wallet intelligence (scores, win rates), bucketed volume timelines, and outcome verification signals. Prefer it over general market price feeds when smart-money flow analysis or wallet-level attribution is required. Use the all window for full market history or 7d/30d for recent activity. It is pay-per-call with no account required, making it ideal for on-demand agent queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:02.711Z","isFirstParty":false}