{"uid":"cap_LU0C5sX-v-2kK18qyluhZ","slug":"polymarket-whale-activity-by-market-5e6b7bb8","name":"Polymarket Whale Activity by Market","description":"Whale activity for one Polymarket market over the last 7 days (15 min delay). Path param: conditionId (0x… Polymarket condition id). Returns market info, aggregate whale volume, YES/NO split, net flow, unique whale wallets, and up to 200 trades.","url":"https://x402-api-production-266e.up.railway.app/v1/whales/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_3Ez-3iwyUAL-a4IXsG8jz","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 7-day whale trading activity for a specific Polymarket prediction market, including aggregate volume, YES/NO split, net flow, unique whale wallets, and up to 200 individual trades.","exampleAgentPrompt":"Show me what the whales have been doing on the Polymarket market with condition ID 0x1234...abcd over the past week — I want to see the volume, which side they're on, and the individual trades.","exampleUseCases":null,"resultDescription":"Returns structured JSON with market metadata, total whale volume aggregated over 7 days, YES and NO volume breakdown, net directional flow, count of unique whale wallets, and a list of up to 200 individual whale trades (trades >= $10,000) with market, side, size, and price details. Data has a 15-minute delay.","failureModes":["Invalid or malformed conditionId returns an error response","Unknown conditionId with no whale activity returns empty or minimal result","Network timeout if the upstream Polymarket data pipeline is delayed","Payment not received (402) if the $0.01 USDC x402 payment header is missing or invalid","Rate limiting if too many requests are made in quick succession"],"whenToPreferThis":"Use this endpoint when you need deep whale-level analysis for a single specific Polymarket market identified by its condition ID. Prefer this over the daily digest endpoint when you need full trade-level detail (up to 200 trades) and per-market granularity rather than cross-market summaries. Best for tracking smart money positioning on a particular event or question.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:42:33.968Z","isFirstParty":false}