# AgentPay Verified Route Call

> AgentPay Verified Route Call is a paid API for AI agents from agentpay.tools, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Discovers, vets, and routes an agent's stated need to the best real x402-compatible tool provider, with sybil-collapse and budget-capped payment

## Facts

- Endpoint: POST https://agentpay.tools/tools/verified_route/call
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentpay-verified-route-call-94b044eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_P_1_NV7Y1GTc8k5gFrjx4

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 agentpay-verified-route-call-94b044eb -d '<json body>'
```

Example prompt: Find me the best verified tool for 'dex pair liquidity' on the Base chain, keeping the downstream cost under $0.50 per call.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover and route to the best available x402-compatible tool for a given task without knowing which provider to call in advance — especially when sybil resistance, budget capping, and quality ranking across 100+ competing listings matter. Prefer it over hardcoded tool URLs when the provider landscape is fragmented or frequently changing.

## Known failure modes

- No surviving providers after sybil collapse — survivors array is empty and recommendation may be absent
- Invalid or unsupported chain filter returns empty results
- budget_usd too low to match any available provider pricing
- Downstream provider catalog temporarily unavailable causing scan failure
- Malformed 'need' string returns no relevant catalog matches

## How this service works

Buyer-side trust oracle for the x402 marketplace: 'I need X, budget $Y — which tool is real?' Sweeps the WHOLE catalog across many queries, collapses sybil/factory clusters (one wallet stamping many fake-distinct listings), ranks the genuinely-used survivors by unique-payer usage, and returns one vetted pick with a ready-to-pay challenge. The credit-bureau check an agent can't do in a single query.

## Output

A structured recommendation including the best-matching tool's URL, name, price in USD, payment address and network, quality score, 30-day call and payer counts, plus a vetting summary showing how many listings were scanned, sybil-collapsed, and how many real providers survived — along with ready-to-pay payment details for immediate x402 use.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "parameters": {
   "type": "object",
   "required": [
    "need"
   ],
   "properties": {
    "need": {
     "type": "string",
     "description": "What the agent needs, e.g. 'dex pair liquidity', 'crypto prices'"
    },
    "chain": {
     "type": "string",
     "description": "Optional chain filter: 'base', 'arbitrum', 'solana'. Empty = all chains. Solana picks are discovery-only (probe coverage: Base only — on-chain delivery unverified)"
    },
    "budget_usd": {
     "type": "number",
     "description": "Max USDC to pay the downstream tool per call (default 1)"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "need": "dex pair liquidity",
 "chain": null,
 "catalog": {
  "scanned": 117,
  "after_vetting": 114,
  "real_providers": 41,
  "unique_wallets": 38,
  "biggest_factory": {
   "pay_to": "0x2bb72231eed3",
   "listings": 72
  },
  "sybil_collapsed": 73
 },
 "vetting": "swept 17 queries → 117 listings → collapsed 73 sybil listings → 41 real providers",
 "survivors": [],
 "budget_usd": "1",
 "recommendation": {
  "url": "https://otto.example/dex",
  "name": "Otto AI",
  "flags": [],
  "pay_to": "0x0e84ddedaae6a7",
  "network": "eip155:8453",
  "quality": 3851,
  "calls30d": 3246,
  "payers30d": 200,
  "price_usd": "0.001",
  "ready_to_pay": {
   "url": "https://otto.example/dex",
   "accepts": {
    "scheme": "exact",
    "network": "eip155:8453"
   },
   "network": "eip155:8453",
   "price_usd": "0.001"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentpay-verified-route-call-94b044eb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentpay.tools](https://www.zero.xyz/host/agentpay.tools/llms.txt)