# ReallyBigMagnet Agent Quote & Purchase Guide

> ReallyBigMagnet Agent Quote & Purchase Guide is a free API for AI agents from agents.reallybigmagnet.com, callable via x402, Free, status unknown (last checked 2026-10-29).

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

## Facts

- Endpoint: POST https://agents.reallybigmagnet.com/zeroclick/agent/quote?utm_source=zero.xyz
- Price: Free
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Provider: agents.reallybigmagnet.com
- Website: https://agents.reallybigmagnet.com
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-reallybigmagnet-com-reallybigmagnet-agent-quote-purchase-guide-1151cf8b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Lm3P-TufB3xUpCPk_4Zms

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-reallybigmagnet-com-reallybigmagnet-agent-quote-purchase-guide-1151cf8b -d '<json body>'
```

Example prompt: Before I spend anything, can you get me a free quote for using the ReallyBigMagnet seller API to geocode 500 addresses — include my budget of $10 USD and assume I'll be paying via x402?

## When to prefer this

Choose this endpoint when you need to plan or cost-check a ReallyBigMagnet API task before committing any funds — especially if you don't yet have a wallet or payment method set up. It is the right first step for any autonomous agent workflow on this platform, as it provides the exact contract, price, and prerequisites needed to proceed. Prefer it over /zeroclick/agent/guide when you want a structured, parseable JSON response rather than pure markdown guidance.

## Known failure modes

- Missing required 'goal' field returns a validation error
- Goal description too vague may result in status 'needs_input' with clarifying questions
- Unsupported task type returns status 'unsupported'
- Service temporarily unavailable returns status 'unavailable'
- Malformed budgetUsd pattern (e.g. non-numeric) causes schema validation failure
- Quantity outside 1–1,000,000 range rejected by schema validation

## 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

A JSON object containing: a status field (quoted, ready, needs_input, blocked, unknown, unsupported, or unavailable), a priceUsd field always set to '0' (this lookup is free), a markdown-formatted guide with the matched API contract, pricing breakdown, prerequisites, and next steps, and a guideUrl pointing to the wallet-free advisor endpoint for further 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-reallybigmagnet-com-reallybigmagnet-agent-quote-purchase-guide-1151cf8b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.reallybigmagnet.com](https://www.zero.xyz/host/agents.reallybigmagnet.com/llms.txt)