{"uid":"cap_JEz7KzrMpd9qCXYWWPoQG","slug":"lonestaroracle-consumerpulse-us-consumer-demand-signal-ed357143","name":"LonestarOracle ConsumerPulse — US Consumer Demand Signal","description":"US consumer-demand signal (retail sales)","url":"https://consumer.lonestaroracle.xyz/consumer","method":"GET","headers":{},"bodySchema":{"name":"ConsumerPulse","tags":["macro","consumer","retail-sales","spending","e-commerce","demand","real-economy"],"type":"object","version":"1.0.0","category":"trading","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"signal":"US consumer demand: Softening. Retail & food-services sales $757B/mo (+0.3% MoM, +4.1% YoY); core ex-autos & gas +3.8% YoY. E-commerce +7.2% YoY (21% of retail); restaurants +5.1% YoY.","consumer_phase":"Softening"}}}},"description":"US consumer-demand signal — the demand-side mirror of CyclePulse. Returns headline retail & food-services sales with month and year trend, the core measure (excluding autos and gasoline — the cleaner underlying-demand read), e-commerce vs restaurant spending, a 13-sector year-over-year breakdown with the strongest and weakest movers, and a plain-English consumer phase (resilient, softening, stalling, or pullback). Use it to read whether the US consumer is accelerating or cooling, gauge discretionary demand and the online-shift, and pair with supply-side (CyclePulse) and macro data. Values are nominal (not inflation-adjusted). Pay-per-call $0.05 in USDC on Base via x402. Data = US Census Advance Retail Trade (MARTS), US government public domain."},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fLcLNqgFEzEWBFb6YGd8u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current US consumer-demand signal derived from Census retail & food-services sales data, including MoM/YoY trends, e-commerce share, sector breakdown, and a plain-English consumer phase label.","exampleAgentPrompt":"What's the latest US consumer demand signal — is the consumer resilient, softening, stalling, or in pullback? Give me the headline retail sales number, core ex-autos-and-gas trend, and e-commerce share.","exampleUseCases":[{"title":"Economic recession risk assessment","prompt":"Pull the latest consumer demand signal and tell me if we're seeing a pullback or stalling phase. I need to know if discretionary spending is cooling and which retail sectors are weakening fastest—this matters for our recession probability model."},{"title":"Investment portfolio sector rotation","prompt":"Show me the current consumer phase and give me the 13-sector breakdown. Which categories are strongest and weakest right now? I want to rebalance my retail and consumer goods holdings based on real spending momentum."},{"title":"Supply chain demand planning","prompt":"What's the current e-commerce share of US retail and is it accelerating or decelerating month-over-month? Also give me the core retail trend ex-autos-and-gas. I need to adjust our inventory forecasts based on actual consumer behavior."}],"resultDescription":"Returns a JSON object with: headline retail & food-services monthly sales (nominal $), MoM and YoY percentage changes, core measure excluding autos & gasoline, e-commerce YoY growth and share of retail, restaurant spending YoY, a 13-sector breakdown with strongest/weakest movers, and a plain-English consumer_phase label (resilient, softening, stalling, or pullback).","failureModes":["Payment not received or insufficient USDC — 402 Payment Required returned","Data not yet updated for latest Census release — stale or pending signal returned","Network timeout or service unavailability — standard HTTP 5xx","Incorrect HTTP method used (only GET/HEAD/DELETE accepted) — 405 Method Not Allowed"],"whenToPreferThis":"Choose this endpoint when you need a pre-synthesized, ready-to-use US consumer demand signal with phase labeling, rather than raw Census data you must parse yourself. Ideal for macro dashboards, economic research agents, investment signal pipelines, and pairing with supply-side indicators like CyclePulse. At $0.05/call via x402 on Base, it is cost-effective for pay-per-use agent workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:19.051Z","isFirstParty":false}