{"uid":"cap_dta6viYATMXyxcChiFAs9","slug":"consumerpulse-f57f54f2","name":"ConsumerPulse","description":"US consumer-demand signal (retail sales)","url":"https://api.aidress.ai/pay/agent_consumer_lonestaroracle_xyz","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_socx36AyEIxFtJE61xQm0","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 a US consumer demand outlook with retail/e-commerce/restaurant sales data, sector movers, and a plain-English consumer phase assessment from Census MARTS data.","exampleAgentPrompt":"What's the current US consumer demand signal? I want to know the phase (resilient, softening, stalling, or pullback), the latest headline retail sales figures, which sectors are the strongest and weakest movers, and how e-commerce is trending.","exampleUseCases":[{"title":"Macro briefing for portfolio manager","prompt":"Give me a quick read on the US consumer right now — what phase are we in, how are headline retail sales trending month-over-month and year-over-year, and which sectors are leading or lagging?"},{"title":"E-commerce demand check for retail analyst","prompt":"Pull the latest ConsumerPulse signal — I specifically want to see e-commerce's share of total retail and its year-over-year growth, plus the core ex-autos and gas number to gauge underlying demand."},{"title":"Pair consumer signal with supply-side data","prompt":"I'm building a macro dashboard — fetch the current ConsumerPulse consumer phase and sector breakdown so I can pair it with supply-chain data and see if demand and supply are moving in sync."}],"resultDescription":"A JSON object containing a plain-English consumer phase label (resilient/softening/stalling/pullback), headline retail and food-services sales in dollar terms with MoM and YoY percentage changes, core retail ex-autos and gas YoY growth, e-commerce percentage of retail and YoY growth, restaurant sales YoY growth, a 13-sector YoY breakdown, and the strongest and weakest sector movers. Values are nominal (not inflation-adjusted).","failureModes":["Payment failure: x402 payment of $0.05 USDC on Base not processed — endpoint returns 402 with payment details","Data not yet released: Census MARTS data may lag by weeks; response may reflect prior month's release","Network timeout: upstream Census data fetch delay causing slow or failed response","Invalid HTTP method: only GET/HEAD/DELETE accepted; POST or PUT returns 4xx error"],"whenToPreferThis":"Choose ConsumerPulse when you need a fast, pre-computed, plain-English US consumer demand signal derived directly from US Census MARTS data without parsing raw government files. It is best suited for macro dashboards, trading signal pipelines, or agents pairing consumer demand with supply-side data (e.g. SupplyChainPulse or CyclePulse). Prefer it over raw Census API calls when you want a structured phase label and sector ranking out of the box. Not suitable when you need inflation-adjusted real spending data or non-US consumer metrics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:15.578Z","isFirstParty":false}