{"uid":"cap_k_XIB9vLEKc822x6KAk2W","slug":"demandex-live-gauge-1ce26324","name":"DemandEx Live Gauge","description":"Paid ($0.10 USDC via x402). Same body as /v1/gauge — POST { \"query\": \"...\", \"category\"?: \"...\" } (query 3..200 chars; body-first, ?query= fallback). Combines the mined corpus with a LIVE Reddit search run at request time (up to 50 posts, subreddits unrestricted) and one LLM synthesis call. Total compute budget is 45 seconds; on timeout you get a 504 and are not charged. Returns the same verdict shape as /v1/gauge (cache is always miss). A zero-match, empty-search query is a real cold verdict (c…","url":"https://api.demandex.dev/v1/gauge/live","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"The product/demand query to gauge with live research (3..200 chars). Required."},"category":{"type":"string","description":"Optional category slug to scope the corpus match."}}},"responseSchema":{"type":"json","example":{"cache":"miss","query":"sony xm5 replacement headband","charged":true,"fetchedAt":"2026-07-18T11:45:00.000Z","rationale":"Live Reddit search plus mined signals show sustained, recent demand for an aftermarket XM5 headband.","topEvidence":[{"quote":"Just found out the XM5 band is glued in — anyone selling a replacement?","upvotes":58,"permalink":"https://reddit.com/r/headphones/comments/def456"}],"verdictScore":86,"demandTemperature":"hot","relatedOpportunities":[{"slug":"sony-wh1000xm5-replacement-headband","score":87.4}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z1sift1DY1GQmP2a_Yzc7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs live research to gauge real-time market demand for a product or query, returning a demand signal score and insights","exampleAgentPrompt":"Can you gauge the live market demand for 'portable cold plunge tubs' — I want to see real-time demand signals before we invest in inventory, scoped to the fitness category if possible.","exampleUseCases":null,"resultDescription":"Returns a live demand gauge result for the queried product or topic, including a demand score and supporting research signals derived from real-time analysis of the market corpus.","failureModes":["Query string shorter than 3 or longer than 200 characters returns validation error","Invalid or unrecognized category slug may return empty or unscoped results","Payment failure via x402 protocol returns 402 with payment details required","Network or upstream research service timeout may return 5xx error","Missing required 'query' field returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need a live, real-time demand signal for a specific product or idea rather than a pre-scored static result. Prefer this over the sibling opportunity card endpoints when you want to research a custom query not already indexed in the catalog, or when freshness and live research matter more than cost efficiency. It costs more ($0.10 vs $0.01–$0.05) but returns current demand intelligence rather than cached opportunity data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:32:13.775Z","isFirstParty":false}