# DemandEx Live Gauge

> DemandEx Live Gauge is a paid API for AI agents from api.demandex.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Performs live research to gauge real-time market demand for a product or query, returning a demand signal score and insights

## Facts

- Endpoint: POST https://api.demandex.dev/v1/gauge/live
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/demandex-live-gauge-1ce26324
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k_XIB9vLEKc822x6KAk2W

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 demandex-live-gauge-1ce26324 -d '<json body>'
```

Example prompt: Can you gauge the live market demand for 'portable cold plunge tubs' — I want to see real-time demand signals before we invest in inventory, scoped to the fitness category if possible.

## When to prefer this

Use this endpoint when you need a live, real-time demand signal for a specific product or idea rather than a pre-scored static result. Prefer this over the sibling opportunity card endpoints when you want to research a custom query not already indexed in the catalog, or when freshness and live research matter more than cost efficiency. It costs more ($0.10 vs $0.01–$0.05) but returns current demand intelligence rather than cached opportunity data.

## Known failure modes

- Query string shorter than 3 or longer than 200 characters returns validation error
- Invalid or unrecognized category slug may return empty or unscoped results
- Payment failure via x402 protocol returns 402 with payment details required
- Network or upstream research service timeout may return 5xx error
- Missing required 'query' field returns 400 bad request

## How this service works

Paid ($0.10 USDC via x402). Same body as /v1/gauge — POST { "query": "...", "category"?: "..." } (query 3..200 chars; body-first, ?query= fallback). Combines the mined corpus with a LIVE Reddit search run at request time (up to 50 posts, subreddits unrestricted) and one LLM synthesis call. Total compute budget is 45 seconds; on timeout you get a 504 and are not charged. Returns the same verdict shape as /v1/gauge (cache is always miss). A zero-match, empty-search query is a real cold verdict (c…

## Output

Returns a live demand gauge result for the queried product or topic, including a demand score and supporting research signals derived from real-time analysis of the market corpus.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "The product/demand query to gauge with live research (3..200 chars). Required."
  },
  "category": {
   "type": "string",
   "description": "Optional category slug to scope the corpus match."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cache": "miss",
  "query": "sony xm5 replacement headband",
  "charged": true,
  "fetchedAt": "2026-07-18T11:45:00.000Z",
  "rationale": "Live Reddit search plus mined signals show sustained, recent demand for an aftermarket XM5 headband.",
  "topEvidence": [
   {
    "quote": "Just found out the XM5 band is glued in — anyone selling a replacement?",
    "upvotes": 58,
    "permalink": "https://reddit.com/r/headphones/comments/def456"
   }
  ],
  "verdictScore": 86,
  "demandTemperature": "hot",
  "relatedOpportunities": [
   {
    "slug": "sony-wh1000xm5-replacement-headband",
    "score": 87.4
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/demandex-live-gauge-1ce26324/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.demandex.dev](https://www.zero.xyz/host/api.demandex.dev/llms.txt)