{"uid":"cap_BtEvJ6rJHeoe1f9lKhF01","slug":"agent402-execute-pro-pay-per-call-tool-router-079a6bc3","name":"Agent402 Execute-Pro: Pay-Per-Call Tool Router","description":"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.","url":"https://agent402.tools/api/route/execute-pro","method":"POST","headers":{},"bodySchema":{"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)."}}},"responseSchema":{"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}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"3.3","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$3.3/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"3.3","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"3.3","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q5x4zxTgJjhfA2b2z99Df","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"3.3","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Cryptographic hash via agent wallet","prompt":"Hash the string 'agent402rocks' using SHA-256 — route it through the agent402 execute-pro endpoint, keep the cost under $0.50, and show me the hex output plus the receipt with the call reference."},{"title":"Auto-route task to cheapest external tool","prompt":"I need to geocode the address '1600 Pennsylvania Ave NW, Washington DC' — use agent402 to find and call the best external x402 tool for this, relay the result back, and don't spend more than $2."},{"title":"FDA recall lookup inside agent workflow","prompt":"Look up any FDA food recalls for 'peanut butter' using the agent402 tool catalog — resolve the right tool automatically from my task description and execute it, then give me the results and what it cost."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:09.972Z","isFirstParty":false}