# LonestarOracle ConsumerPulse — US Consumer Demand Signal

> LonestarOracle ConsumerPulse — US Consumer Demand Signal is a paid API for AI agents from consumer.lonestaroracle.xyz, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: GET https://consumer.lonestaroracle.xyz/consumer
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lonestaroracle-consumerpulse-us-consumer-demand-signal-ed357143
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JEz7KzrMpd9qCXYWWPoQG

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability lonestaroracle-consumerpulse-us-consumer-demand-signal-ed357143
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

US consumer-demand signal (retail sales)

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lonestaroracle-consumerpulse-us-consumer-demand-signal-ed357143/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from consumer.lonestaroracle.xyz](https://www.zero.xyz/host/consumer.lonestaroracle.xyz/llms.txt)