{"uid":"cap_IcQxJViUdLL6GfxKb7PlV","slug":"agent402-tools-smart-order-router-find-execute-99ce8260","name":"agent402.tools Smart Order Router — Find & Execute","description":"Describe a task in plain language (or name a tool slug) and the Smart Order Router resolves the best-matching tool across this catalog and the open x402/MPP seller index, then runs it in the same call and returns the result with a receipt. Flat price covers any tool listed at $0.005 or less. Use it when an agent wants one paid request that both finds and executes the right capability.","url":"https://agent402.tools/api/route/execute","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.005)"},"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.01,"resolvedBy":"slug","routingFeeUsd":0.009,"underlyingPriceUsd":0.001}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VtqQfAr4U-gqY7G4hDxeU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves the best-matching tool from a plain-language task description (or exact slug) and immediately executes it in a single call, returning results plus a receipt for $0.01 USDC.","exampleAgentPrompt":"Use the agent402 Smart Order Router to compute the SHA-256 hash of the string 'hello world' — just describe the task in plain English and run it in one shot, keeping the tool price at or below $0.005.","exampleUseCases":null,"resultDescription":"Returns the output of the matched and executed tool (format varies by tool), along with the resolved tool's slug and name, the underlying price paid, and a payment receipt confirming the $0.01 USDC charge.","failureModes":["No tool found matching the task description — returns a ranking failure or empty match","Requested tool's price exceeds maxUsd ceiling — call is refused before execution","Invalid or unknown slug provided — tool not found error","params object does not match the resolved tool's inputSchema — validation error","Downstream tool itself fails — error from the underlying tool is surfaced","Payment or x402 authorization failure — call rejected before routing"],"whenToPreferThis":"Prefer this endpoint when you want to find and run a tool in a single round trip without knowing the exact slug, or when you want to describe a task in plain language and let the router pick the best tool. Also ideal when you already know the slug and want to skip the discovery step entirely. Use over separate /api/find + /api/call flows when latency and simplicity matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:24.052Z","isFirstParty":false}