# Agoranome Demand Gap Finder

> Agoranome Demand Gap Finder is a paid API for AI agents from api.agoranome.com, paid per call via x402, $1/call, status unknown (last checked 2026-10-28).

Identifies unmet buyer demand and weak-supply gaps in the x402 API marketplace so sellers know what to build or improve next

## Facts

- Endpoint: GET https://api.agoranome.com/v1/seller/gaps?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agoranome-demand-gap-finder-d01749b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rRjVZFirCQVfgr12JyNtZ

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 agoranome-demand-gap-finder-d01749b6
```

Example prompt: Can you check the Agoranome demand gap finder to see which x402 API categories have the most unmet buyer demand right now — especially around anything AI or data-related?

## When to prefer this

Use this endpoint when you are an x402 API seller (or prospective seller) wanting to identify unserved or underserved demand in the agent API marketplace before committing to building or listing a new API. It is specifically designed for the x402 / Bazaar ecosystem and surfaces real buyer search signal, making it more actionable than generic market research. Prefer this over generic keyword trend tools when you need marketplace-native demand data tied directly to what AI agent buyers are actually paying to find.

## Known failure modes

- No topic match found — returns empty gaps array if the specified topic has no buyer search history
- Overly broad topic string may return many low-score gaps with little actionable signal
- Payment failure (x402 USDC settlement not completed) — request blocked before processing
- Service unavailable — API returns 5xx if marketplace index is being refreshed
- Topic string exceeds 80-character limit — request rejected with validation error

## How this service works

What x402 API should I build? The demand gap finder runs up to 150 Bazaar searches phrased the way buyer agents phrase tasks and ranks the unmet demand: tasks whose top results are weak (no listings, few payers, thin descriptions or a poor fit), with the evidence for each. Public Bazaar data only, joined with measured repeat demand per category.

## Output

Returns a list of demand gaps, each with a task description, a 0-100 opportunity score, a verdict of 'open' (no meaningful supply) or 'weak' (poor-quality supply exists), a count of repeat buyer searches in the last 30 days for that category, and a headline summarizing the total number of underserved buyer searches and the biggest opportunity found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "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": {
      "topic": {
       "type": "string",
       "maxLength": 80,
       "description": "A topic or category to search around; every category if omitted"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "gaps": [
    {
     "why": [
      "..."
     ],
     "task": "...",
     "score": "<0-100>",
     "verdict": "<open|weak>",
     "category_repeat_calls_30d": "<n or null>"
    }
   ],
   "headline": "<n> of <searches> buyer searches find weak results; biggest opening: <task>."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agoranome-demand-gap-finder-d01749b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agoranome.com](https://www.zero.xyz/host/api.agoranome.com/llms.txt)
