{"uid":"cap_Vum5RDnyTdaiTy2yuzfVH","slug":"x402-field-instruments-x402-route-api-routing-liveness-ea42f531","name":"x402 Field Instruments – x402-route (API Routing & Liveness)","description":"Seven account-free paid tools for source integrity, x402 catalog search, preflight, liveness, routing, price drift, and batch verification.","url":"https://bj7e26lfpo4fthvr35hczdipby.srv.us/v1/x402-route","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["need"],"properties":{"need":{"type":"string","description":"The capability you need, in your own words"},"max_price":{"type":"string","description":"Budget ceiling per call in USDC"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"need":"FCC radio license lookup by company","verified":[{"live":{"verdict":"live_paid","price_usdc":1.25,"safe_to_pay":true},"resource":"https://..."}],"budget_usdc":2,"routeVersion":"1.0","recommendation":{"why":["verified live just now","within budget 2","seen 3x, reliability 1","price matches its catalog listing"],"resource":"https://api.govparse.io/v1/fcc/licenses/search","price_usdc":1.25},"rejected_before_verification":[{"reason":"known gone in the liveness index","resource":"https://..."}]}},"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_-waUlx3lK6AIqJUTtD1yA","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":"Given a natural-language description of a capability need, finds live x402 API endpoints that match, verifies their liveness, checks pricing against a budget, and recommends the best one to call.","exampleAgentPrompt":"I need to find a live, reliable x402 API that can do FCC radio license lookups by company name — my budget is $2 per call, so route me to the best option available right now.","exampleUseCases":[{"title":"Agent self-routing to live data source","prompt":"I'm building an agent that needs to look up corporate filings — find me the best live x402 API for that within a $1.50 per call budget and tell me why you picked it."},{"title":"Budget-aware API discovery for court records","prompt":"Can you find a working x402 endpoint for searching US court records? I don't want to pay more than $0.75 per call — only show me ones that are verified live right now."},{"title":"Automated preflight before agent pipeline runs","prompt":"Before I kick off my data enrichment pipeline, check which x402 APIs for address verification are currently live and within a $0.50 budget, and recommend the most reliable one."}],"resultDescription":"Returns a JSON object containing: the matched and recommended API endpoint URL with its price in USDC, a liveness verdict (e.g. 'live_paid'), a safe_to_pay flag, reliability signals (how many times it's been seen), reasons for the recommendation, and a list of rejected endpoints with reasons (e.g. 'known gone in liveness index').","failureModes":["No live endpoints found matching the described need — returns empty verified list","All matching endpoints exceed the max_price budget — recommendation absent","Liveness check times out for a candidate endpoint — verdict may be stale or unavailable","Ambiguous or overly broad 'need' description yields irrelevant matches","Payment of $0.05 USDC fails or is rejected — endpoint returns 402 without result"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to dynamically discover and route to the right x402 paid API at runtime, especially when liveness and budget compliance matter. Prefer it over static API catalogs when you need real-time verification that an endpoint is actually live and priced within budget. It is especially valuable in agent pipelines that must self-select among multiple competing paid data sources without hard-coding a specific provider.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:33:42.311Z","isFirstParty":false}