# Agent402 Execute-Pro: Pay-Per-Call Tool Router

> Agent402 Execute-Pro: Pay-Per-Call Tool Router is a paid API for AI agents from agent402.tools, paid per call via x402, $3.3/call, status unknown (last checked 2026-09-16).

Routes a plain-language task or tool slug to the best-matching tool in a 500+ catalog, executes it, and returns the result along with a payment receipt — all paid in USDC via x402.

## Facts

- Endpoint: POST https://agent402.tools/api/route/execute-pro
- Price: $3.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-execute-pro-pay-per-call-tool-router-079a6bc3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BtEvJ6rJHeoe1f9lKhF01

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 agent402-execute-pro-pay-per-call-tool-router-079a6bc3 -d '<json body>'
```

Example prompt: Use my agent402 wallet to execute the 'sha256' tool — hash the string 'hello world' and keep the cost under $1; I want to see the result and the payment receipt.

## When to prefer this

Choose this endpoint when you want a single entry point to execute any of 500+ tools without managing individual API keys, and when you want verifiable on-chain payment receipts per call. Prefer it over calling individual tool endpoints directly when you don't know the exact tool in advance and want automatic task-to-tool routing. Also prefer it when you need to route to external x402 sellers with payment relayed on your behalf.

## Known failure modes

- Tool slug not found in catalog — returns error if slug is invalid
- Task description cannot be resolved to a matching tool — ranker returns no match
- Tool price exceeds maxUsd ceiling — request refused before execution
- External tool call fails or times out — result marked untrustedContent or error returned
- Insufficient USDC balance in agent wallet — payment fails, tool not executed
- params object does not match resolved tool's inputSchema — validation error returned

## How this service works

Describe a task (or name a slug) and the Smart Order Router resolves the best-matching tool and RUNS it in the same call - flat $3.3 covering any tool listed at $3 or less, from THIS host's catalog or any external seller in the open index - x402 sellers, or MPP sellers on Tempo (paid on your behalf over x402 or MPP, result relayed). One payment, one request, result + receipt. /api/route quotes which tier a task needs; pricier tools return a self-correcting 409 with their direct route.

## Output

A JSON object with two top-level keys: 'result' (the raw output of the resolved tool, shape varies by tool) and 'receipt' (timestamp, resolved slug, route path, seller identity, call reference for auditability, amount paid in USD, routing fee, and underlying tool price).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "slug": {
   "type": "string",
   "description": "Exact tool slug to execute (skips ranking). Provide task OR slug."
  },
  "task": {
   "type": "string",
   "description": "Plain-language task, e.g. \"sha256 hash of a string\" - resolved via the same ranker as /api/find. Provide task OR slug."
  },
  "maxUsd": {
   "type": "number",
   "description": "Refuse tools listed above this underlying price (default and ceiling: $3)"
  },
  "params": {
   "type": "object",
   "description": "Input for the resolved tool, matching its inputSchema (default {})"
  },
  "include": {
   "type": "string",
   "description": "Where to route: default runs a tool from THIS host's catalog; \"external\" routes to the best-matching x402 seller in the OPEN index and pays it on your behalf (result relayed, marked untrustedContent). Requires task (not slug)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "hex": "…",
   "algo": "sha256",
   "base64": "…"
  },
  "receipt": {
   "ts": "2026-07-10T00:00:00.000Z",
   "slug": "hash",
   "route": "POST /api/hash",
   "seller": "internal",
   "callRef": "sha256:…  (recomputable: sha256 of {\"nonce\":<payment authorization nonce>,\"slug\":…,\"ts\":…} - null on nonce-less calls)",
   "paidUsd": 3.3,
   "resolvedBy": "slug",
   "routingFeeUsd": 0.009,
   "underlyingPriceUsd": 0.001
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-execute-pro-pay-per-call-tool-router-079a6bc3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)
