{"uid":"cap_JGqE2ibIl5V41XrXy3vR6","slug":"scanna-heat-signal-single-market-deep-dive-b2104c81","name":"Scanna Heat Signal – Single Market Deep Dive","description":"Full signal breakdown for one prediction market on Polymarket or Kalshi: heat score, volume-spike multiplier, lookback and 24h volume, liquidity, order-flow bias and score, volatility, whale activity, and both YES and NO prices. POST a market_id, taken from any GET /hot entry, optionally with a custom lookback window. Computed signal, not raw odds. Billed on success. JSON.","url":"https://api.scanna.xyz/heat","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["market_id"],"properties":{"market_id":{"type":"string","description":"Condition ID. Obtainable from markets[].market_id of any GET /hot result."},"lookback_minutes":{"type":"integer","default":30,"maximum":1440,"minimum":5,"description":"Minutes of trade history to analyse (5-1440)"}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["market_id","platform","question","heat_score","volume_spike_x","liquidity_usd","volume_lookback","volume_24h","flow_bias","flow_score","volatility","price_yes","price_no","signals"],"properties":{"signals":{"type":"array","items":{"type":"string"},"description":"Human-readable signal sentences, not machine tokens"},"platform":{"enum":["polymarket","kalshi"],"type":"string"},"price_no":{"type":"number"},"question":{"type":"string"},"flow_bias":{"enum":["buy","sell","neutral"],"type":"string"},"market_id":{"type":"string"},"price_yes":{"type":"number"},"flow_score":{"type":"number"},"heat_score":{"type":"number","description":"Composite 0-1"},"volatility":{"enum":["low","medium","high"],"type":"string","description":"Derived volatility band"},"volume_24h":{"type":"number"},"liquidity_usd":{"type":"number"},"volume_spike_x":{"type":"number"},"whale_activity":{"type":["object","null"]},"volume_lookback":{"type":"number"},"hours_to_resolve":{"type":["integer","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.010001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.010001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.010001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hy85lrJX8fk_yYunLX0sR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.010001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a full computed signal breakdown for one Polymarket or Kalshi prediction market, including heat score, volume-spike multiplier, order-flow bias, whale activity, volatility, liquidity, and YES/NO prices.","exampleAgentPrompt":"Pull the full signal breakdown for Polymarket market ID 0x1234abcd — I want the heat score, volume-spike multiplier, order-flow bias, whale activity, and current YES/NO prices using the default lookback window.","exampleUseCases":[{"title":"Spotting momentum before a news event","prompt":"Run the full heat signal on Polymarket market 0xabc123 right now — I want to see the volume spike multiplier, order-flow bias, whale activity, and whether the heat score is spiking ahead of tonight's announcement."},{"title":"Evaluating liquidity before entering a position","prompt":"Before I trade on Kalshi market XYZ, can you pull the Scanna heat breakdown for it? I especially need to see the liquidity figure, YES/NO prices, and volatility score."},{"title":"Monitoring insider-risk signals on a whale-active market","prompt":"Check the heat signal for Polymarket market 0xdeadbeef with a 48-hour lookback — I want to know if there's elevated whale activity or order-flow bias that might signal informed trading."}],"resultDescription":"A JSON object containing the computed heat score (0–100 scale), volume-spike multiplier, lookback volume, 24-hour volume, liquidity in USD, order-flow bias direction and score, volatility metric, whale activity indicator, and current YES and NO prices for the specified prediction market.","failureModes":["Invalid or unknown market_id returns a 404 or error JSON","Market not yet indexed returns an empty or null result","Malformed POST body (missing market_id) returns a 400 validation error","Upstream data unavailable causes a 503 or degraded signal response","Payment failure (insufficient USDC) causes a 402 response before computation"],"whenToPreferThis":"Use this endpoint when you need a comprehensive, computed signal profile for a single known prediction market — not just raw odds. It is the right choice when you need heat scoring, whale tracking, order-flow bias, and volatility in one call. Prefer this over raw price endpoints (like the /prices sibling) when you want actionable trading signals rather than just current YES/NO quotes, and over the risk-grade endpoint when you need granular numeric metrics rather than a letter grade.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:44:39.844Z","isFirstParty":false}