{"uid":"cap_Lgk1Wlw_mQWuO1aRj_TL1","slug":"agent402-tools-execute-plus-pay-per-call-tool-router-f405e3d8","name":"Agent402.tools Execute-Plus (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 $0.05 covering any tool listed at $0.04 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-plus","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: $0.04)"},"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":0.05,"resolvedBy":"slug","routingFeeUsd":0.009,"underlyingPriceUsd":0.001}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oAn5VwXSuz0SiDzzyf6s4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a plain-language task or slug to the best-matching tool in a 525-tool catalog (or the open x402 index), executes it, pays the underlying provider on your behalf, and returns the result with a verifiable receipt — all in one $0.05 USDC call.","exampleAgentPrompt":"Research the current financials and analyst sentiment for NVDA stock — use the agent402 execute-plus router with task 'research a stock', params set to ticker NVDA, and keep the underlying tool price under $0.04.","exampleUseCases":[{"title":"One-call stock research report","prompt":"Pull together a full research summary for TSLA — fundamentals, recent news, and analyst sentiment — using agent402's execute-plus endpoint with task 'research a stock' and ticker TSLA, staying under the $0.04 underlying price cap."},{"title":"Domain SEO audit on demand","prompt":"Run a complete SEO audit on example.com right now — use the agent402 execute-plus router with task 'audit a domain SEO' and pass example.com as the domain param, paying via my USDC wallet on Base."},{"title":"SQL query over Base blockchain","prompt":"I need to run this SQL query against Base chain data: 'SELECT block_number, gas_used FROM blocks ORDER BY block_number DESC LIMIT 10' — dispatch it through agent402 execute-plus with task 'run SQL over Base' and pass the query in params."}],"resultDescription":"A JSON object with two top-level keys: 'result' (the raw output of the resolved and executed tool, shape varies by tool) and 'receipt' (a structured audit record containing timestamp, tool slug, route, seller, call reference with recomputable sha256 hash, amount paid in USD, how it was resolved, routing fee, and the underlying tool price).","failureModes":["Tool not found for the given task or slug — ranker returns no match above threshold","maxUsd cap too low — the resolved tool's price exceeds the caller's budget cap ($0.04 ceiling enforced)","Payment failure — insufficient USDC balance or unsupported chain","External routing unavailable — no matching x402 seller found in the open index for the task","Invalid params — tool inputSchema validation fails for the provided params object","Both task and slug provided or neither provided — input schema requires exactly one","External tool returns untrusted or malformed content — relayed as-is with untrustedContent flag","Rate limiting or tool-side timeout on the underlying provider"],"whenToPreferThis":"Use execute-plus when you want to dispatch a natural-language task or a known tool slug and get a complete result plus a verifiable payment receipt in a single call, without pre-registering or holding an API key. It is the right choice when you need smart routing (the ranker picks the best tool), optional external x402 marketplace routing, a hard USD price cap, and cryptographic auditability via the callRef hash. Prefer it over the bare /api/find endpoint when you want execution, not just discovery, and over building your own tool-dispatch loop when the 525-tool catalog is likely to have coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:05.810Z","isFirstParty":false}