# market2000.xyz Declared-Intent Demand API

> market2000.xyz Declared-Intent Demand API is a paid API for AI agents from market2000.xyz, paid per call via x402, $10/call, status unknown (last checked 2026-09-14).

Returns aggregated declared-intent demand data from AI agents — what agents said they needed, their willingness-to-pay, and which endpoints they chose — over a configurable lookback window.

## Facts

- Endpoint: GET https://market2000.xyz/api/demand/intent
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/market2000-xyz-declared-intent-demand-api-e79f58d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TsCLcdXjjpE08TGWXbhiD

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 market2000-xyz-declared-intent-demand-api-e79f58d7
```

Example prompt: Pull the top 20 declared agent needs from the last 7 days, including willingness-to-pay stats and the top origins agents actually chose — I want to understand what AI agents are asking for and what they're willing to pay.

## When to prefer this

Choose this endpoint when you need to understand what AI agents are actively seeking in natural language — their declared intent — rather than inferring demand from endpoint hit counts alone. It is uniquely valuable for market research on AI agent demand, pricing benchmarks, and identifying gaps in the API ecosystem. Prefer it over general web analytics or endpoint traffic data when willingness-to-pay and agent-stated intent are the key signals you need.

## Known failure modes

- Invalid `days` value outside 1-90 range returns an error
- Invalid `limit` value outside 1-50 range returns an error
- Payment not included or insufficient triggers 402 Payment Required
- No data available for the requested window returns empty arrays
- Rate limiting or quota exceeded returns 429 error

## How this service works

Declared-intent demand — what agents SAID they needed, not just which endpoint they hit.

Sourced from the free /api/discover agent router: the natural-language need an agent typed, its willingness-to-pay (from reported outcomes), and where it actually went (referrals = revealed preference). This is intent the endpoint-hit radar structurally cannot see.

HOW TO CALL:
  GET /api/demand/intent?days=7&limit=20

PARAMETERS:
  days  — lookback window, 1-90 (default 7)
  limit — top terms / origins returned, 1-50 (default 20)

RESPONSE: top_declared_needs[], willingness_to_pay{median/p90/max}, top_chosen_origins[], helped_rate, our_top_rank_rate. Aggregate-only.

PRICING: $0.05 per call.

## Output

Returns an aggregated snapshot including: a ranked list of top declared natural-language needs expressed by agents, willingness-to-pay statistics (median, p90, max), the top origins/endpoints agents actually chose (revealed preference), the helped_rate (share of needs that got fulfilled), and the our_top_rank_rate. All data is aggregate-only with no individual agent data exposed.

## 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",
    "queryParams"
   ],
   "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": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/market2000-xyz-declared-intent-demand-api-e79f58d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market2000.xyz](https://www.zero.xyz/host/market2000.xyz/llms.txt)