{"uid":"cap_pP5PYvsI3YtTU6Fa_qYH0","slug":"api-seerium-xyz-5dab5df4","name":"Seerium Polymarket Whale Radar by Wallet","description":"Crypto and prediction market intelligence through x402.","url":"https://api.seerium.xyz/v1/prediction/whale-radar/by-wallet","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"},"queryParams":{"type":"object","required":["wallet"],"properties":{"limit":{"type":"number","minimum":1,"description":"Optional maximum recent wallet trades to return."},"wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Required tracked 0x EVM wallet address to inspect for recent Polymarket whale trades. Use /v1/prediction/whale-radar/top-10-recent-moves first to discover active wallets."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"total":1,"trades":[{"name":"Example Whale","side":"BUY","size":20000,"tier":"alpha","price":0.49,"score":98,"amount":9800,"wallet":"0x1234567890abcdef1234567890abcdef12345678","outcome":"Yes","tradeId":"whale_trade_example","timestamp":"2026-03-25T11:58:30.000Z","marketSlug":"us-x-iran-permanent-peace-deal-by-may-31-2026","marketTitle":"US x Iran permanent peace deal by May 31, 2026?","profileImage":null}],"wallet":{"name":"Example Whale","tier":"alpha","score":98,"active":true,"wallet":"0x1234567890abcdef1234567890abcdef12345678","tracked":true,"updatedAt":"2026-03-25T11:59:00.000Z","profileImage":null},"updatedAt":"2026-03-25T11:59:00.000Z"},"meta":{"requestId":"req_example_123","updatedAt":"2026-03-25T11:59:30.000Z","freshnessMs":30000,"generatedAt":"2026-03-25T12:00:00.000Z"},"product":{"id":"whale-radar-by-wallet","name":"Polymarket Whale Wallet API","path":"/v1/prediction/whale-radar/by-wallet","price":"$0.1000","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.1000","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.1000","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":5,"wallet":"0x1111111111111111111111111111111111111111"}}},"response":{"data":{"total":0,"trades":[],"wallet":{"name":null,"tier":null,"score":null,"active":false,"wallet":"0x1111111111111111111111111111111111111111","tracked":false,"updatedAt":null,"profileImage":null},"updatedAt":null},"meta":{"wallet":"0x1111111111111111111111111111111111111111","tracked":false,"requestId":"2af347f0-e27b-4fcd-bda6-4545b387b5a6","updatedAt":null,"freshnessMs":null,"generatedAt":"2026-06-18T05:22:40.874Z","totalTrades":0,"returnedTrades":0},"product":{"id":"whale-radar-by-wallet","name":"Polymarket Whale Wallet API","path":"/v1/prediction/whale-radar/by-wallet","price":"$0.0030","method":"GET","accepts":[{"payTo":"0x81832eEDe3a4ad96CB3D7cA09977636D912fd3D5","price":"$0.0030","scheme":"exact","network":"eip155:8453"},{"payTo":"2h752kAbb9z1jpdSzqMEYg9JHv6TPJ6T2BfAJMyjLFtZ","price":"$0.0030","scheme":"exact","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"}],"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"]},"service":"seerium-x402-api"}},"exampleRequest":{"limit":5,"wallet":"0x1111111111111111111111111111111111111111"},"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PzwcNFOPROdQB89az4GgY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns whale trade history, wallet metadata, tier, score, and activity for a single tracked 0x Polymarket wallet address.","exampleAgentPrompt":"What's the whale tier, score, and most recent Polymarket trades for wallet 0x1234567890abcdef1234567890abcdef12345678? Show me the last 10 trades.","exampleUseCases":[{"title":"Monitor competitor trading patterns","prompt":"Can you check what that whale wallet 0xabc123def456... has been trading on Polymarket lately? I want to see if they're making similar bets to us and what their whale score is."},{"title":"Validate whale status before partnership","prompt":"Is the wallet 0x789fedcba321... actually a recognized Polymarket whale? Pull their tier, score, and recent activity so I can assess if they'd be a good collaborative trader."},{"title":"Track major player market moves","prompt":"I keep seeing trades from wallet 0xdef456abc789... - can you look up their full Polymarket trading history and tell me what tier whale they are? I want to follow their next big moves."}],"resultDescription":"Returns whale trades (up to the requested limit), wallet metadata including tier classification and whale score, and recent activity summary for the specified 0x wallet on Polymarket.","failureModes":["Wallet address not in tracked whale list — returns empty or not-found response","Invalid 0x address format — schema validation error","Wallet has no Polymarket activity — returns empty trades array","limit parameter out of range — validation error","Payment not fulfilled (x402) — 402 Payment Required response","Network or upstream data provider outage — 5xx error"],"whenToPreferThis":"Use this endpoint when you need to profile a specific known wallet address on Polymarket — e.g. you already have the 0x address and want its whale classification, score, and trade history. Prefer this over the top-whales feed endpoint when you need per-wallet detail rather than a ranked leaderboard.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:55:39.560Z","isFirstParty":false}