{"uid":"cap_DFIn2qcKjk3OFYSp9YDLa","slug":"402signal-route-lookup-d133a35c","name":"402Signal Route Lookup","description":"402Signal checks the endpoint, price and recipient before your agent pays, on x402 and MPP, and returns a signed record verifiable offline. $0.003 on Base, Solana, and Algorand only when a qualifying live offer is found; a miss is free. Seller payment is separate. Your agent keeps the wallet. Evidence enters the PQ Trust log on Algorand MainNet. require_route_binding=true adds a signed v4 receipt for buyer-side comparison before signing. Guide: https://402signal.com/developers#route-binding","url":"https://402signal.com/route","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string"},"need":{"type":"string"},"require_transparency":{"type":"boolean","description":"Require a durable leaf and signed checkpoint receipt on HTTP 200. Default false; require_route_binding=true also requires transparency. Receipt failure after settlement remains billed. Private replay records support bounded recovery of the original response; they are not long-term evidence storage. Keep your own copy outside public logs."},"require_route_binding":{"type":"boolean","description":"Opt in to a signed v4 route binding; implies require_transparency even if false. Default false; ordinary requests keep v3. A ranked winner that cannot bind may fall through to the next already-probed selectable bindable candidate; 503 route_binding_unavailable only when none remain. wrapExactAuthorize reports state=binding_unavailable with keep_calling_route true; policy working, not a crash. Buyer verifies raw response JSON with a pinned log key and compares the current seller request and challenge before signing. Expiry or changed terms do not undo a settled checking fee. Guide: https://402signal.com/developers#route-binding"}}},"responseSchema":{"type":"json","example":{"url":"https://example.com/x402/balance","live":true,"health":{"live":true,"status":402,"last_probe":"2026-08-29T22:00:00-04:00","latency_ms":87,"has_402_challenge":true},"status":402,"probed_at":"2026-08-29T22:00:00-04:00","latency_ms":87,"has_402_challenge":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZmuAz3bmhqLsx3ThssthZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live, probed x402 endpoint URL (or an honest miss) for a given URL or need, confirming whether the endpoint is currently alive and returning a proper 402 challenge.","exampleAgentPrompt":"Is there a live x402 endpoint available for balance checking? I want a URL that's currently up and returning a real 402 payment challenge — check 402Signal and tell me what you find.","exampleUseCases":[{"title":"Discover live x402 payment endpoint","prompt":"I need a working x402 endpoint for checking account balances — can you query 402Signal with that need and tell me the URL, whether it's live, and how fast it responded?"},{"title":"Verify x402 route before calling it","prompt":"Before my agent tries to call https://example.com/x402/balance, can you run it through 402Signal to confirm it's actually live and returning a proper 402 challenge right now?"},{"title":"Agent selects healthiest x402 route","prompt":"My agent needs to pick an x402 data endpoint — use 402Signal to find a live one matching 'price feed' and give me the URL along with its latency and last probe time so I can pick the freshest one."}],"resultDescription":"A JSON object containing: the resolved URL, a live boolean, a health object with liveness status, HTTP status code (typically 402), last probe timestamp, latency in milliseconds, and whether a 402 challenge header is present. On an honest miss, the live field is false with no URL.","failureModes":["No matching live endpoint found — returns honest miss with live: false and no URL","Input URL or need is malformed or missing — likely returns a 400 or validation error","The probed endpoint is temporarily down — returns live: false with last known probe data","Payment of $0.01 USDC fails or is not authorized — request is rejected (fail-closed behavior)","Network timeout reaching the target endpoint — latency_ms reflects timeout, live: false"],"whenToPreferThis":"Use 402Signal when your agent needs to discover or verify that a specific x402-gated endpoint is currently alive and serving a proper 402 payment challenge, especially before spending money on a call. It is the right choice over static directories when freshness and liveness confirmation matter, as it probes endpoints in real time and reports actual HTTP status, latency, and challenge presence. Prefer it when you have a candidate URL or a description of what you need and want a fail-closed, honest answer about reachability.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:37:17.770Z","isFirstParty":false}