{"uid":"cap_OirbcAGualJfavgQsW5cD","slug":"arkham-x402-polymarket-top-events-breakdown-d28c2abc","name":"Arkham x402 Polymarket Top Events Breakdown","description":"Get Arkham Polymarket top event breakdown. $0.40 per call.","url":"https://api.arkm.com/x402/polymarket/top-events-breakdown","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"period":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Period: 1d, 1w, 1m, all. Default: 1d."},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Polymarket trader address."},"eventId":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Polymarket event ID."}}},"responseSchema":{"type":"json","example":{"eventId":30615,"markets":[],"eventTitle":"World Cup Winner ","userAddress":"0xBDDF61Af533fF524D27154e589d2D7A81510C684"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.4","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.4/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.4","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-JvZz9uKtXqSZC1V-bOoc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.4","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a breakdown of top Polymarket prediction market events with associated markets and wallet-level participation data.","exampleAgentPrompt":"Pull up the Arkham breakdown for Polymarket event 30615 — I want to see which markets are under that event and what wallet activity looks like for address 0xBDDF61Af533fF524D27154e589d2D7A81510C684.","exampleUseCases":[{"title":"Track whale wallets on prediction markets","prompt":"Can you use Arkham to show me the Polymarket top events breakdown for wallet 0xBDDF61Af533fF524D27154e589d2D7A81510C684? I want to know which events they're involved in and what markets are under those events."},{"title":"Research a specific Polymarket event","prompt":"Get me the full breakdown for Polymarket event 30615 — the World Cup Winner event — I need to see all the markets listed under it and any wallet attribution data Arkham has."},{"title":"Monitor top prediction market activity","prompt":"What are the top Polymarket events right now according to Arkham? I want to see the event titles and the markets under each of them so I can figure out where the most activity is happening."}],"resultDescription":"Returns a JSON object containing the eventId, eventTitle, an array of markets associated with the event, and a userAddress representing the wallet being analyzed — providing a structured breakdown of Polymarket event participation and market composition.","failureModes":["Invalid or unknown eventId returns empty markets array","Invalid Ethereum address format for userAddress causes request failure","Insufficient USDC balance for x402 payment results in 402 Payment Required","Rate limiting or API key issues return 401/403 errors","Event not yet indexed by Arkham returns incomplete or null data"],"whenToPreferThis":"Choose this endpoint when you need on-chain wallet-attributed intelligence about Polymarket events specifically — combining prediction market data with Arkham's blockchain analytics. Prefer this over generic Polymarket APIs when wallet identity, attribution, or cross-referencing with on-chain behavior is needed. Best suited for agents doing DeFi research, whale tracking, or prediction market analytics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:48:08.918Z","isFirstParty":false}