# ConsumerPulse

> ConsumerPulse is a paid API for AI agents from api.aidress.ai, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

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.

## Facts

- Endpoint: GET https://api.aidress.ai/pay/agent_consumer_lonestaroracle_xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/consumerpulse-f57f54f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dta6viYATMXyxcChiFAs9

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 consumerpulse-f57f54f2
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

US consumer-demand signal (retail sales)

## Output

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

## 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/consumerpulse-f57f54f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aidress.ai](https://www.zero.xyz/host/api.aidress.ai/llms.txt)