# WithZero Agent API Quote & Purchase Guide

> WithZero Agent API Quote & Purchase Guide is a free API for AI agents from agents.withzero.xyz, callable via x402, Free, status unknown (last checked 2026-11-17).

Returns a free, wallet-proof quote with matching API contract details, pricing, prerequisites, and next steps for a described task — no purchase is executed.

## Facts

- Endpoint: POST https://agents.withzero.xyz/zeroclick/agent/quote?utm_source=zero.xyz
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-withzero-agent-api-quote-purchase-guide-aa461bfe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5VhXs4jfLS4pwGX0V6XQ3

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 agents-withzero-xyz-withzero-agent-api-quote-purchase-guide-aa461bfe -d '<json body>'
```

Example prompt: Before I commit any funds, can you get me a free quote from WithZero for running 500 image generation API calls with a total budget of $10, paying via x402, to see the exact contract, price, and next steps?

## When to prefer this

Use this endpoint when an agent or user wants to plan or budget a WithZero API task before committing funds, when no wallet is available and a zero-cost lookup is needed, or when the correct API contract and prerequisites for a described goal are unknown. Prefer this over directly calling a paid endpoint when uncertainty exists about cost, compatibility, or setup steps.

## Known failure modes

- status='needs_input' when the goal description is too vague for WithZero to match a specific API
- status='unsupported' when no WithZero API matches the described task
- status='unavailable' when the quoting service is temporarily unreachable
- status='blocked' when prerequisites cannot be met (e.g. required credentials or plan not satisfied)
- status='unknown' when the system cannot determine a clear answer
- Validation error if goal field is missing or exceeds 2000 characters
- Validation error if budgetUsd does not match the required numeric pattern

## How this service works

Describe your task to get the matching API contract, prices, prerequisites and next steps. This is a $0 wallet-proof lookup, not the seller's paid service. No purchase is executed. Without a wallet, use /zeroclick/agent/guide.

## Output

Returns a JSON object with a status field (e.g. 'quoted', 'ready', 'needs_input'), a priceUsd always set to '0' confirming the lookup is free, a markdown guide string containing the matched API contract, exact pricing, prerequisites, and recommended next steps, and a guideUrl pointing to a wallet-free advisor endpoint for follow-up planning or recovery.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "goal"
 ],
 "properties": {
  "goal": {
   "type": "string",
   "maxLength": 2000,
   "minLength": 1,
   "description": "Describe the task and known inputs. Do not include credentials."
  },
  "payment": {
   "enum": [
    "x402",
    "mpp",
    "card"
   ],
   "type": "string",
   "description": "Known payment method for the eventual purchase, independent of this free lookup's wallet proof."
  },
  "quantity": {
   "type": "integer",
   "maximum": 1000000,
   "minimum": 1,
   "description": "Number of API calls, not returned items. Omit when unknown; describe desired output in goal."
  },
  "budgetUsd": {
   "type": "string",
   "pattern": "^(0|[1-9]\\d{0,8})(\\.\\d{1,6})?$",
   "description": "Total cash budget in USD. A quote does not authorize spending."
  },
  "requirements": {
   "type": "string",
   "maxLength": 300,
   "minLength": 1
  },
  "humanAvailable": {
   "type": "boolean",
   "description": "Whether a human is in the loop; omit when unknown. Executing a human's request without further interruptions does not by itself mean false."
  },
  "budgetExclusive": {
   "type": "boolean"
  },
  "reviewAfterCalls": {
   "type": "integer",
   "maximum": 1000000,
   "minimum": 1
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "status",
  "priceUsd",
  "guide",
  "guideUrl"
 ],
 "properties": {
  "guide": {
   "type": "string",
   "description": "Markdown guidance containing the task result, exact contract, pricing and next steps when available. No purchase is executed."
  },
  "status": {
   "enum": [
    "quoted",
    "catalog",
    "ready",
    "needs_input",
    "blocked",
    "unknown",
    "unsupported",
    "unavailable"
   ],
   "type": "string"
  },
  "guideUrl": {
   "type": "string",
   "format": "uri",
   "description": "Wallet-free advisor endpoint for further planning or recovery."
  },
  "priceUsd": {
   "type": "string",
   "const": "0"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-withzero-agent-api-quote-purchase-guide-aa461bfe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)
