Get the Polymarket events with the most trading today

Call this to show what Polymarket is trading right now. data.items lists the active, open events with the highest trading volume in the last 24 hours, busiest first. Sona reads them from Polymarket's public Gamma API once a minute and keeps them in memory, so a list can trail Polymarket by about a minute. limit is how many events to return, 1 to 50, 20 by default.

An item has the event_id, slug and title of the event, volume_24h_usd, its all-time volume_total_usd (null when Polymarket sends none) and liquidity_usd, its end_date (null when it has none) and its markets, at most 10 open ones. A market is a question, its label (Polymarket's short name for the market within its event, such as a candidate, empty for the main market of a game), its outcomes (the name of each outcome) and outcome_prices, one price from 0 to 1 per outcome, in the same order as outcomes, with Yes first on a Yes or No market. The dollar amounts here are plain JSON numbers, because this is a live feed and not ledger data, so they are not exact ledger figures.

data.fetched_at says when Sona took the copy. data.stale is true when Polymarket could not be reached on the latest try and this is the last good copy. The history routes of this tag end on 2026-04-24, but this one shows the present, so it has no coverage object and meta.finality is none. data.source is polymarket-gamma. Polymarket's data is not affiliated with Sona.

Other venues. With venue=kalshi, polymarket-us or hyperliquid the answer is the most active markets of that venue from the recorded data, ranked by 24-hour volume (by total volume for polymarket-us, which reports no 24-hour figure). An item is a VenueMarket with market_id, title, status, result, close_time, yes_price, the volume and open interest in dollars (null when the venue reports none, never 0) and as_of. data.kind stays pm_top_markets and data.venue names the venue. Pass a market_id to /v1/pm/markets/{venue}/{id}/history. levr has no market list.

Venues. A venue other than polymarket is read from what Sona's collector recorded, so its answer has no block: meta.finality is none, meta.as_of is empty and no Sona-* header is sent. An answer for Levr Bet would be labelled eip155:143, the chain it runs on, if it ever carried a block. Every venue answer has its own data.coverage object (venue, since, last_ok, mode, wallets, gaps, note) in place of the Polymarket one, and says in note what is not recorded. Answers for a venue are kept for 30 seconds, and a stale one for 5 seconds. An unknown venue, or one the route cannot serve, is pm-api's 400 invalid_query, passed through. While the recorded data cannot be read a venue answer is 503 upstream_unavailable with Retry-After: 1.