{"uid":"cap_VRvT6UNygas8PRveJJfQ_","slug":"scanna-yes-no-price-lookup-daf3aa08","name":"Scanna Yes/No Price Lookup","description":"Returns yes/no prices for up to 50 condition_ids, read from an in-process market cache; no DB or upstream call. Prices are up to ~60s stale (updated_at is the cache refresh time). Unknown or long-tail ids return found:false with null prices in a 200, so an all-null response is still billable. 503 when the cache is not hydrated.","url":"https://api.scanna.xyz/prices","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":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated condition_ids. Blanks are dropped; only the FIRST 50 are read and the rest are discarded silently."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["prices","count"],"properties":{"count":{"type":"integer","description":"Ids READ (≤50), not ids found"},"prices":{"type":"array","items":{"type":"object","required":["condition_id","found"],"properties":{"found":{"type":"boolean","description":"false ⇒ the id is not in the cache; prices are null"},"platform":{"enum":["polymarket","kalshi",null],"type":["string","null"]},"price_no":{"type":["number","null"]},"price_yes":{"type":["number","null"]},"condition_id":{"type":"string","description":"Echoed back exactly as supplied"}}},"description":"One entry per requested id, in request order — misses included, never omitted"},"updated_at":{"type":["string","null"],"format":"date-time","description":"Cache refresh time"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005006","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.005006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QJPHfQzABQTQkP99fXhHb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns cached yes/no prices for up to 50 prediction market condition IDs from Polymarket and Kalshi, served from an in-process memory cache with ~60s staleness.","exampleAgentPrompt":"What are the current yes and no prices for these Polymarket condition IDs: 0xabc123, 0xdef456, and 0x789ghi?","exampleUseCases":[{"title":"Real-time prediction market price check","prompt":"Can you pull the current yes and no prices for these five Polymarket condition IDs: 0xabc1, 0xdef2, 0xghi3, 0xjkl4, 0xmno5?"},{"title":"Arbitrage opportunity detection","prompt":"I want to compare yes prices across these 20 condition IDs on Polymarket and Kalshi — can you fetch all their current prices so I can spot any discrepancies?"},{"title":"Portfolio market price snapshot","prompt":"Get me the latest yes and no prices for all the prediction market condition IDs in my watchlist: 0xa1b2, 0xc3d4, 0xe5f6, 0xg7h8, 0xi9j0 — I need to know which ones Scanna actually has in its cache."}],"resultDescription":"A JSON array of price entries — one per requested condition ID in request order — each containing condition_id (echoed), found (boolean), price_yes (0–1 float or null), price_no (0–1 float or null), platform ('polymarket', 'kalshi', or null), plus a top-level count (number of IDs read, max 50) and updated_at (ISO timestamp of last cache refresh). Unknown IDs return found:false with null prices but are still included and still billable.","failureModes":["503 Service Unavailable when the in-process cache has not yet been hydrated after a cold start","All prices null with found:false for unknown or long-tail condition IDs — response is still 200 and still billable","Silent truncation of IDs beyond the first 50 — no error is returned for the discarded IDs","Prices may be up to ~60 seconds stale relative to live market state","Blank entries in the comma-separated ids string are silently dropped"],"whenToPreferThis":"Choose this endpoint when you need fast, low-latency yes/no price lookups for up to 50 prediction market condition IDs and can tolerate ~60s cache staleness. It is ideal for polling or repeated price checks where speed matters more than real-time accuracy. Prefer it over DB-backed alternatives when you need sub-second response times and don't need guaranteed freshness. Not suitable when you need guaranteed live prices, historical price data, or resolution outcomes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:48:03.225Z","isFirstParty":false}