US consumer-demand signal (retail sales)

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x52Ab53912D37759B2ad364f22dD06B16714b6C06",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "3nmeVj5m9Uq2hSTfsVsn3tJMHRJQNMKR1AjzyUJbrSgw",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "50000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "type": "http"
      },
      "output": {
        "example": {
          "consumer_phase": "Softening",
          "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."
        },
        "format": "json",
        "type": "object"
      }
    },
    "schema": {
      "category": "trading",
      "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.",
      "name": "ConsumerPulse",
      "properties": {
        "input": {
          "properties": {
            "method": {
              "enum": [
                "GET",
                "HEAD",
                "DELETE"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {},
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "consumer_phase": "Softening",
              "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."
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "tags": [
        "macro",
        "consumer",
        "retail-sales",
        "spending",
        "e-commerce",
        "demand",
        "real-economy"
      ],
      "type": "object",
      "version": "1.0.0"
    }
  },
  "bc_kg64bd18": {}
}

curl "https://consumer.lonestaroracle.xyz/consumer"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://consumer.lonestaroracle.xyz/consumer");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://consumer.lonestaroracle.xyz/consumer")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header