# Machina API Quote & Purchase Guide

> Machina API Quote & Purchase Guide is a free API for AI agents from agents.machina.gg, callable via x402, Free, status unknown (last checked 2026-10-22).

Accepts a task description and returns a free, wallet-proof quote with matching API contract details, pricing, prerequisites, and next steps for purchasing Machina sports data APIs.

## Facts

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

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-machina-gg-machina-api-quote-purchase-guide-0a900d81 -d '<json body>'
```

Example prompt: I want to get match forecasts and fixture results for the 2026 World Cup — can you look up which Machina APIs I need, what they'll cost for about 500 calls, and what I need to do to get started? My budget is around $20.

## When to prefer this

Choose this endpoint when you need to plan, budget, or explore Machina's World Cup 2026 API surface before committing to a purchase. It is the right first step when you don't yet know which endpoint to call, what it costs, or what prerequisites are required. It is especially useful for autonomous agents that need to verify feasibility and price before authorizing spend, or for users without a wallet who need guidance. Prefer this over directly calling a paid endpoint when the task requirements, cost, or API contract are uncertain.

## Known failure modes

- goal field missing or empty — returns validation error
- goal description too vague to match a specific API — status returns 'needs_input' or 'unknown'
- requested capability not available in Machina catalog — status returns 'unsupported' or 'unavailable'
- budgetUsd format invalid (non-numeric or wrong pattern) — schema validation failure
- quantity out of range (0 or over 1,000,000) — schema validation failure

## How this service works

Machina's World Cup Intelligence APIs cover the 2026 tournament: canonical entity resolution across providers, fixtures, standings, squads, injuries, per-player performance context, Dixon-Coles match forecasts with historical backtests, and finished editorial content. Every endpoint is a synchronous POST that returns grounded, source-cited JSON. This server is a pay-per-use, transparent proxy in front of Machina Sports's own API: it handles identity, payment, and proxying. Agents can purchase autonomously or with their human's approval. The complete verified paid surface is listed at /openapi.json, the source of truth for available operations. Each operation here carries its live price in x-payment-info. Use the operations and details here when they meet your needs. Filtered specs contain only matching operations; if you cannot find what you need here, use search or the service catalog. The live catalog at /manifest.json is authoritative for prices and any free included units (prices[].includedUnits) - some meters include free usage per account before any charge, reserved for agents claimed by a human with a verified email.

## Output

Returns a status field (e.g. 'quoted', 'ready', 'needs_input'), a priceUsd always set to '0' confirming no charge for this lookup, a Markdown guide with task result, exact API contract, pricing, and next steps, and a guideUrl pointing to the wallet-free advisor endpoint for further planning or recovery.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "guide": "Task support is not established. Use the advisor to resolve missing details before purchasing.",
  "status": "unknown",
  "guideUrl": "https://agents.machina.gg/zeroclick/agent/guide",
  "priceUsd": "0"
 }
}
```

## More

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