{"uid":"cap_bfUkrgQx8M-PH-9S8PSJ5","slug":"scanna-hot-markets-feed-a9434532","name":"Scanna Hot Markets Feed","description":"Ranked feed of the most active prediction markets across Polymarket and Kalshi. Each entry carries a composite heat score plus the components behind it: 24h volume, volume-spike multiplier, liquidity, order-flow bias, whale activity and current YES price. Filter by category, platform or minimum volume. Served from a cached feed; updated_at is its age. Billed on success, including an empty result. JSON.","url":"https://api.scanna.xyz/hot","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":[],"properties":{"limit":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"Markets to return"},"category":{"type":"string","description":"Tag category, e.g. politics, sports, crypto"},"platform":{"enum":["polymarket","kalshi"],"type":"string","description":"Restrict to one venue"},"min_volume":{"type":"number","minimum":0,"description":"Minimum 24h volume in USD"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["markets","updated_at"],"properties":{"markets":{"type":"array","items":{"type":"object","required":["market_id","platform","question","heat_score","volume_spike_x","liquidity_usd","volume_24h","price_yes","flow_bias","tags","signals"],"properties":{"tags":{"type":"array","items":{"type":"string"}},"signals":{"type":"array","items":{"type":"string"},"description":"Human-readable signal sentences, not machine tokens"},"platform":{"enum":["polymarket","kalshi"],"type":"string"},"question":{"type":"string"},"flow_bias":{"enum":["buy","sell","neutral"],"type":"string"},"market_id":{"type":"string"},"price_yes":{"type":"number"},"heat_score":{"type":"number","description":"Composite 0-1"},"volume_24h":{"type":"number"},"liquidity_usd":{"type":"number"},"volume_spike_x":{"type":"number"},"whale_activity":{"type":["object","null"]},"hours_to_resolve":{"type":["integer","null"]}}}},"updated_at":{"type":"string","format":"date-time"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010002","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.010002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EeUisE9yhF2neThIdNBwR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.010002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked feed of the hottest prediction markets on Polymarket and Kalshi, scored by a composite heat metric that combines 24h volume, volume spike, liquidity, order-flow bias, and whale activity.","exampleAgentPrompt":"Show me the top 15 hottest prediction markets right now across both Polymarket and Kalshi — filter to politics only and only include markets with at least $10,000 in 24h volume, and tell me the heat score, volume spike, and current YES price for each.","exampleUseCases":[{"title":"Spot trending crypto prediction markets","prompt":"What are the top 10 hottest crypto prediction markets on Polymarket right now? I want to see the heat score, volume spike, and whether order flow is leaning buy or sell."},{"title":"Monitor political markets for whale activity","prompt":"Pull the hottest political prediction markets across both Polymarket and Kalshi — up to 20 of them — and flag any that have whale activity. Only show markets with at least $5,000 in 24h volume."},{"title":"Find liquid sports markets to trade","prompt":"Show me the top 5 most active sports prediction markets on Kalshi right now, with their liquidity in USD and current YES prices."}],"resultDescription":"A JSON object with an array of ranked market entries (up to 50) and a feed timestamp. Each market includes: market_id, platform, question text, composite heat_score (0–1), volume_24h (USD), volume_spike_x multiplier, liquidity_usd, price_yes, flow_bias (buy/sell/neutral), whale_activity object, hours_to_resolve, category tags, and human-readable signal sentences explaining the heat score components.","failureModes":["Empty markets array returned if no markets meet filter criteria — still billed","Stale data: updated_at may lag by minutes due to caching; not real-time tick data","Invalid platform enum value returns a validation error","min_volume or limit out of allowed range returns a 400-level error","Network or upstream venue outage may cause feed to serve a very stale snapshot"],"whenToPreferThis":"Use this endpoint when you need a pre-ranked, multi-signal view of the most active prediction markets across both Polymarket and Kalshi in a single call. It is superior to querying each venue's raw API separately because it normalizes volume, applies spike detection, adds whale activity and order-flow signals, and computes a composite heat score — saving significant aggregation work. Prefer it over Scanna's individual market endpoints when you want a discovery feed rather than data on a known market_id.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:42:10.108Z","isFirstParty":false}