{"uid":"cap_PsCwZM3fCkuWwdpu2vz-r","slug":"prediction-trending-0e31169e","name":"prediction-trending","description":"Top trending prediction events by 24-hour traded volume: a normalized list with 24h and total volume, liquidity, market count, a top-market summary, close date, status and a link-back.","url":"https://api.agentstools.dev/prediction/trending","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Max events (default 15, cap 25)"},"venue":{"enum":["polymarket"],"type":"string","description":"Venue (default polymarket)"},"closed":{"type":"boolean","description":"Include closed events (default false)"}}}},"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_d7ssbkC_ZlZ0q396ezlpH","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 the top trending prediction market events ranked by 24-hour traded volume, with volume stats, liquidity, market count, top-market summary, close date, and status.","exampleAgentPrompt":"Show me the top 15 trending prediction markets on Polymarket right now, including their 24-hour volume, total volume, and liquidity.","exampleUseCases":[{"title":"Daily prediction market briefing","prompt":"What are the top 10 trending prediction events on Polymarket today, sorted by 24-hour trading volume? Give me each event's volume, liquidity, and when it closes."},{"title":"Monitoring hot political betting markets","prompt":"Show me the most actively traded prediction markets right now — I want to see what political or major world events people are betting on most heavily in the last 24 hours."},{"title":"Finding liquid markets for trading","prompt":"Pull the top 25 open prediction markets by 24-hour volume on Polymarket, including liquidity and market count, so I can find the most liquid ones to trade."}],"resultDescription":"A normalized list of up to 25 trending prediction market events, each including the event name, 24-hour traded volume, total all-time volume, available liquidity, number of sub-markets, a top-market summary, close date, current status, and a direct link back to the event on the venue.","failureModes":["Invalid limit value (outside 1–25 range) returns a validation error","Unsupported venue value returns an enum validation error","No trending events found may return an empty list","Downstream Polymarket data unavailability may cause stale or empty results","Rate limiting or payment failure (x402) may block access"],"whenToPreferThis":"Use this endpoint when you need a ranked, ready-to-consume summary of the most actively traded prediction market events by 24-hour volume, specifically on Polymarket. Prefer this over building your own Polymarket scraper or using raw market APIs when you want normalized volume, liquidity, and metadata in a single call. Ideal for daily briefings, market monitoring agents, or identifying where speculative interest is concentrated.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:58:57.383Z","isFirstParty":false}