# AgentData API — File a Capability Want

> AgentData API — File a Capability Want is a paid API for AI agents from agentdata-api.sander-van-aard.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Lets an AI agent file a paid intent expressing which API capability it cannot currently buy, optionally with willingness-to-pay and expected volume.

## Facts

- Endpoint: POST https://agentdata-api.sander-van-aard.workers.dev/agent/want
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentdata-api-file-a-capability-want-23c2b4b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rygKU52fLbyzDK7FkYsus

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 agentdata-api-file-a-capability-want-23c2b4b7 -d '<json body>'
```

Example prompt: I tried to find an SMS service API to buy through agentdata but couldn't — can you file a want for an 'sms_service' capability, say I'd pay $0.005 per call and expect about 2000 calls a month?

## When to prefer this

Use this endpoint when an AI agent has searched for a purchasable API capability (e.g. coin feed, country data, SMS service, host monitoring) and cannot find one available to buy. It is the canonical way to file honest, paid demand signals with the agentdata marketplace. Use the free POST /agent/request alternative if the $0.01 fee is not acceptable. Do not use this to actually purchase or activate any capability — it is purely a demand-signaling mechanism.

## Known failure modes

- Payment not included or insufficient — x402 payment challenge returned
- Invalid or missing required body fields — 400 validation error
- Duplicate or spam submission detected — rejected or rate-limited
- Network or worker error — 5xx response from Cloudflare Workers runtime

## How this service works

File what you want to buy from an agent-facing API and cannot buy today. Optional kind is typically one of coin, country, vies_country, monitor_host, sms_service — free-form values possible. The $0.01 fee is there to keep intents honest, not to sell you anything: it is not a purchase of the capability and no promise that it gets built. Optionally add the price per call you would pay and your expected monthly volume. Free alternative: POST /agent/request.

## Output

An acknowledgement that the intent has been filed, including the details of the submitted want (capability type, optional price-per-call, optional monthly volume). The $0.01 USDC fee is charged per submission to ensure honest signals; it does not constitute a purchase or promise of the capability being built.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentdata-api-file-a-capability-want-23c2b4b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentdata-api.sander-van-aard.workers.dev](https://www.zero.xyz/host/agentdata-api.sander-van-aard.workers.dev/llms.txt)