{"uid":"cap_7j9Ani6gxPgzJfftVLJYL","slug":"arkham-x402-polymarket-top-events-66620f4f","name":"Arkham x402 - Polymarket Top Events","description":"Get Arkham Polymarket top events. $2.00 per call.","url":"https://api.arkm.com/x402/polymarket/top-events","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Max entries (1-200). Default: 100"},"order":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Sort order: desc (top wins) or asc (top losses). Default: desc"},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Pagination offset. Default: 0"},"period":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Time period: 1d, 1w, 1m, all. Default: 1d"}}},"responseSchema":{"type":"json","example":[{"rank":1,"eventId":511447,"iconUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer ball-bba4025f77.png","imageUrl":"https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer ball-bba4025f77.png","periodPnl":"1242863.7688589205","eventTitle":"Belgium vs. IR Iran - More Markets","tradeCount":3311,"userAddress":"0x204f72f35326db932158CBA6AdfF0B9A1DA95e14"}]},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","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":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KOuvM2iA4lMC8sUvj2Msb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of top Polymarket prediction market events with associated trader performance metrics and PnL data.","exampleAgentPrompt":"Pull the top Polymarket events ranked by period PnL using Arkham's data feed — I want to see which prediction market events and traders are performing best right now.","exampleUseCases":[{"title":"Identify top Polymarket traders by PnL","prompt":"Show me the top Polymarket events right now, ranked by profit and loss, so I can see which traders are making the most money and on what events."},{"title":"Prediction market trend monitoring","prompt":"What are the hottest Polymarket events today? I want to see the top-ranked ones by trade count and PnL so I can spot which markets have the most activity."},{"title":"Crypto trading intelligence research","prompt":"Use Arkham to pull the top Polymarket event leaderboard — I need the event titles, trader wallet addresses, and their PnL for my research on prediction market behavior."}],"resultDescription":"Returns a JSON array of ranked prediction market events from Polymarket, each containing rank position, event ID, event title, icon and image URLs, period PnL (in USD), trade count, and the top trader's wallet address associated with that event.","failureModes":["Insufficient USDC balance for x402 payment — request blocked before processing","Invalid or missing API key — 401 unauthorized response","Polymarket data temporarily unavailable — upstream data source error","Malformed POST body — 400 bad request","Rate limiting if too many requests are made in a short period"],"whenToPreferThis":"Choose this endpoint when you need ranked, curated Polymarket prediction market event data with trader-level wallet intelligence and PnL metrics in a single call. Prefer this over generic Polymarket APIs when you also want on-chain wallet attribution (Arkham's core strength) tied to market performance. Best suited for agents doing trading research, leaderboard monitoring, or identifying whale activity on prediction markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:56:51.747Z","isFirstParty":false}