# PredictLeads Agent Quote & Purchase Guide

> PredictLeads Agent Quote & Purchase Guide is a free API for AI agents from agents.predictleads.com, callable via x402, Free, status healthy (last checked 2026-10-30, last successful call 2026-10-07).

Returns a free, wallet-free API contract quote, pricing details, prerequisites, and next steps for a described task against the PredictLeads company intelligence API — no purchase is executed.

## Facts

- Endpoint: POST https://agents.predictleads.com/zeroclick/agent/quote?utm_source=zero.xyz
- Price: Free
- Payment: x402
- Status: healthy
- Last checked: 2026-10-30
- Last successful call: 2026-10-07
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.predictleads.com
- Website: https://agents.predictleads.com
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-predictleads-com-predictleads-agent-quote-purchase-guide-19ff07ef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yuSHF_ylqcT_WtF7zXBLf

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-predictleads-com-predictleads-agent-quote-purchase-guide-19ff07ef -d '<json body>'
```

Example prompt: Before I spend anything, can you get me a free quote from PredictLeads for pulling job openings data on roughly 200 companies — I have a $50 budget and plan to pay by card?

## When to prefer this

Use this endpoint as a mandatory first step before calling any paid PredictLeads endpoint, especially when the agent does not yet know the exact API path, price, or prerequisites for a task. It is also the right choice when no wallet is yet provisioned — this endpoint requires zero payment — and when you want to compare cost against a budget before committing. Prefer this over /zeroclick/agent/guide when you want a structured quote (status + priceUsd fields) rather than plain advisory text.

## Known failure modes

- 'needs_input' status returned when the goal description is too vague to match a contract
- 'unsupported' returned when the described task doesn't correspond to any available PredictLeads endpoint
- 'unavailable' returned if the underlying catalog or pricing data cannot be fetched
- 'blocked' returned if prerequisites such as identity or payment method eligibility cannot be satisfied
- Malformed goal string (over 2000 chars or empty) results in a 400/validation error
- Invalid budgetUsd format (non-numeric or wrong pattern) causes schema validation failure

## 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 status ('quoted', 'ready', 'needs_input', 'blocked', 'unknown', 'unsupported', or 'unavailable'), a confirmed $0 price for this lookup call, a markdown-formatted guide containing the matched API contract, exact pricing, prerequisites, and recommended next steps, plus a guideUrl pointing to the wallet-free advisor endpoint for follow-up planning.

## 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. False recommends anonymous auth for a new autonomous identity; 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-predictleads-com-predictleads-agent-quote-purchase-guide-19ff07ef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.predictleads.com](https://www.zero.xyz/host/agents.predictleads.com/llms.txt)