Api Endpoint

LoneStarOracle

US consumer-demand signal (retail sales)

Open interactive test console

Offering

Provider
consumer.lonestaroracle.xyz
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Financial Analysis
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://consumer.lonestaroracle.xyz/consumer
MIME type
application/json
First seen
2026-10-16T01:50:03.601Z
Last seen
Tags
Macro, consumer, retail-sales, spending, e-commerce, X402, financial-data, real-economy, lonestaroracle, equities, Crypto, compliance, Risk, Data

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.05 USDC
Atomic price: 50000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.05 USDC
Atomic price: 50000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Payment option 3
50000 atomic units
Atomic price: 50000 · Network: eip155:5042 · Asset: 0x3600000000000000000000000000000000000000 · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "50000",
    "payTo": "0x52Ab53912D37759B2ad364f22dD06B16714b6C06"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "50000",
    "payTo": "3nmeVj5m9Uq2hSTfsVsn3tJMHRJQNMKR1AjzyUJbrSgw"
  },
  {
    "scheme": "exact",
    "network": "eip155:5042",
    "asset": "0x3600000000000000000000000000000000000000",
    "amount": "50000",
    "payTo": "0xeF2a4B6756895aAf1374640dcFCD4947959442ab"
  }
]

Observed health

Status
Healthy
Latest latency
39 ms
Average latency
622 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "required": [
    "type",
    "method"
  ],
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {}
    }
  }
}

Output 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"
}