{"uid":"cap_PeDCirosdDHFegvL0qVFw","slug":"scanna-live-predict-25218c79","name":"Scanna Live Predict","description":"One market_id in, one live CatBoost probability out, plus market_price, divergence and a ~28-field feature snapshot. Features come from the worker-maintained DB serving state, not request-time compute, and snapshot_at is stamped at request time, so stale state looks fresh. Confidence band often nulls to unavailable. No empty 200: missing data is a 404.","url":"https://api.scanna.xyz/live-predict","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":["market_id"],"properties":{"market_id":{"type":"string","description":"Condition ID of an ACTIVE market. Absent is 400; not in the live cache is 404 market_not_found; fewer than 5 trades is 404 insufficient_data."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["market_id","prediction_status"],"properties":{"market_id":{"type":"string"},"divergence":{"type":["number","null"],"description":"predicted_probability - market_price, 3dp. OMITTED when either side is missing."},"market_price":{"type":["number","null"],"description":"Current YES price; null when the market has no finite price"},"model_source":{"type":"string"},"divergence_pp":{"type":["number","null"],"description":"Same signal in percentage points, 1dp. Omitted with divergence."},"feature_count":{"type":"integer","description":"Features the model consumed"},"confidence_low":{"type":["number","null"],"description":"null when no real interval exists — see confidence_band"},"confidence_band":{"enum":["unavailable"],"type":"string","description":"Present ONLY when the band was nulled; absent when the interval is real"},"confidence_high":{"type":["number","null"],"description":"null when no real interval exists — see confidence_band"},"features_snapshot":{"type":"object","description":"~28 raw feature values. Field set varies with the serving path and the order-book/Manifold enrichments, so it is not pinned here; snapshot_at is REQUEST time.","additionalProperties":true},"prediction_status":{"enum":["provisional","canonical_enforced"],"type":"string","description":"Serving-state label, NOT a per-prediction accuracy claim"},"predicted_probability":{"type":["number","null"],"description":"Live model probability 0-1"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.050011","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.050011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.050011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.050011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7MQH781oXNOkc-ADinMBU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.050011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live CatBoost-generated win probability, current market price, divergence signal, and a ~28-field feature snapshot for a single active Polymarket prediction market.","exampleAgentPrompt":"What's Scanna's model probability and market divergence for Polymarket condition ID 0x1234abcd right now — is the current price higher or lower than the CatBoost prediction?","exampleUseCases":[{"title":"Spotting mispriced prediction markets","prompt":"Check the Scanna live prediction for Polymarket market 0xabc123 — I want to know the model's probability versus the current market price and how big the divergence is."},{"title":"Pre-trade model sanity check","prompt":"Before I place a bet on Polymarket condition 0xdef456, can you pull the Scanna live prediction and show me the confidence band, predicted probability, and what features the model used?"},{"title":"Automated arbitrage signal monitoring","prompt":"Fetch the Scanna live-predict score for Polymarket condition 0x789xyz and tell me the divergence in percentage points so I can decide if it's worth trading."}],"resultDescription":"A JSON object containing the market_id, predicted probability, current YES market price, divergence (predicted minus market price, to 3 decimal places), divergence_pp (same in percentage points, 1dp), confidence_low and confidence_high (or confidence_band='unavailable' when no real interval exists), prediction_status ('provisional' or 'canonical_enforced'), model_source, feature_count, and a features_snapshot object with ~28 raw feature values stamped at request time. Returns 404 if the market is not in the live cache or has fewer than 5 trades; 400 if market_id is absent.","failureModes":["404 market_not_found: market_id is valid but not in the live worker cache","404 insufficient_data: market has fewer than 5 trades and cannot be scored","400: market_id query parameter is absent","confidence_band='unavailable': confidence interval could not be computed, confidence_low/high will be null","features_snapshot may reflect stale worker DB state even though snapshot_at is request time","Divergence and divergence_pp fields are omitted entirely when either predicted probability or market_price is missing"],"whenToPreferThis":"Use this endpoint when you need a machine-learning-derived probability estimate for a specific active Polymarket market alongside its current market price and divergence signal in a single call. Prefer this over the risk-grade endpoint when you need a numeric probability rather than a letter grade, or when you want the raw feature snapshot for further analysis. Best suited for trading signal generation, mispricing detection, or pre-trade model validation on individual markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:40:08.773Z","isFirstParty":false}