{"uid":"cap_rGp_uX_G7ht9X49z6ZGNT","slug":"x402-endpoint-risk-preflight-924e7249","name":"x402 Endpoint Risk Preflight","description":"Topdog-shaped endpoint risk preflight: one x402 URL in, pay/avoid/cap verdict out with live 402 probe, hosted graph evidence, examples, and exact autopay stop conditions. Price 0.20 USDC on Base via x402. Free preview: https://x402-market-intel-mcp.mtree.workers.dev/preview/x402_endpoint_preflight?source=x402_manifest. Demo: https://x402-market-intel-mcp.mtree.workers.dev/demo/x402_endpoint_preflight. Contact: https://x402-market-intel-mcp.mtree.workers.dev/contact.","url":"https://x402-market-intel-mcp.mtree.workers.dev/v1/x402/x402_endpoint_preflight","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"url":{"type":"string"},"method":{"type":"string"},"resource":{"type":"string"},"budget_usdc":{"type":"number"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"url":"https://example-api.service.com/v1/data/premium","method":"GET","resource":"premium_dataset","budget_usdc":5},"response":{"ok":true,"score":53,"verdict":"manual_review_before_pay","examples":{"request":{"method":"GET","resource":"premium_dataset","budget_usdc":5},"paid_retry_policy":{"reject_if":["payTo changes","amount exceeds cap","resource binding mismatch","Payment-Required cannot be parsed"],"max_spend_usdc":0,"require_fresh_402":true,"only_retry_same_method_url_body":true}},"resource":"premium_dataset","freshness":{"source":"live 402 probe + hosted CDP/PayAI graph","observed_at":"2026-06-05T23:54:01.000Z"},"risk_flags":["not_found_in_hosted_x402_graph","missing_or_zero_price","live_probe_failed"],"next_action":"Fix or verify flagged payment/schema/readback issues before autopay.","generated_at":"2026-06-05T23:54:01.000Z","payment_terms":{"method":"GET","pay_to":null,"network":"eip155:8453","resource":"premium_dataset","price_usdc":null,"live_status":null,"amount_atomic":null,"resource_binding":"unknown","payment_required_parseable":false},"product_shape":"one_x402_url_in_pay_manual_review_or_avoid_policy_out","buyer_decision":{"reason":"not_found_in_hosted_x402_graph, missing_or_zero_price, live_probe_failed","decision":"manual_review_before_pay","spend_cap_usdc":0},"evidence_summary":{"calls_30d":0,"has_schema":false,"payers_30d":0,"registries":[],"live_402_ok":false,"has_examples":false,"found_in_graph":false,"dataset_fresh_at":null,"revenue_30d_usdc":0},"execution_policy":{"verdict":"manual_review_before_pay","stop_conditions":["live unpaid route is not 402","Payment-Required header missing/unparseable","resource/payTo/amount mismatch","schema or examples missing for autonomous caller","no fresh registry/readback evidence for seller"],"required_followups":["run seller diagnostic fixes","re-register once","capture readback or exact blocker"],"max_autonomous_spend_usdc":0},"payment_contract":{"asset":null,"method":"POST","pay_to":null,"source":"indexed_registry_row","network":null,"resource":"premium_dataset","price_usdc":null,"amount_atomic":null,"requested_resource":"premium_dataset","live_terms_verified":false,"max_timeout_seconds":null,"cache_control_no_store":null,"registry_terms_available":false},"directory_submission_matrix":[{"status":"fix_first","blocker":"live unpaid route must return parseable x402 402 challenge","surface":"AgentCash / x402scan","proof_to_collect":"agentcash check/discover/register plus search readback","submit_or_readback_hint":"agentcash check premium_dataset --format json"},{"status":"fix_first","blocker":"402index live probe expects x402, not L402, on paid routes","surface":"402index","proof_to_collect":"submit as protocol x402, then record listing/search readback","submit_or_readback_hint":"https://402index.io/?q=premium_dataset"},{"status":"fix_first","blocker":"Bazaar quality drops without schemas and examples","surface":"Coinbase Bazaar / Agent402 Bazaar","proof_to_collect":"resource count, quality score, source=bazaar, payTo/domain readback","submit_or_readback_hint":"complete one CDP-facilitated settlement and expose Bazaar extension schema/examples"},{"status":"fix_first","blocker":"live unpaid route must return parseable x402 402 challenge","surface":"x402gle / OpenDexter","proof_to_collect":"opendexter audition plus host/resource page readback","submit_or_readback_hint":"npx -y @dexterai/opendexter@latest audition premium_dataset --json"},{"status":"fix_first","blocker":"GET/HEAD/POST probes need 402 behavior and schemas","surface":"Decixa / live-probe directories","proof_to_collect":"verified listing URL, x402 verified, uptime, schema compliance","submit_or_readback_hint":"submit canonical paid POST route premium_dataset"}],"scanner_compatibility_checks":[{"fix":"return numeric x402Version: 2 in the Payment-Required payload","check":"x402_v2_number","status":"fail","finding":"missing x402Version"},{"fix":"use network eip155:8453, not a free-text chain alias","check":"base_caip2_network","status":"fail","finding":"missing network"},{"fix":"encode USDC atomic amount as a decimal string","check":"atomic_amount_string","status":"fail","finding":"missing amount"},{"fix":"include the seller payTo wallet in accepts[0].payTo","check":"pay_to_present","status":"fail","finding":"missing payTo"},{"fix":"bind payment.resource.url to the exact route buyers will retry after paying","check":"resource_binding","status":"unknown","finding":"missing resource.url"},{"fix":"send both Payment-Required and x-payment-required for scanner compatibility","check":"dual_payment_headers","status":"warn","finding":"Payment-Required=false x-payment-required=false"},{"fix":"add Cache-Control: no-store on 402 responses","check":"no_store_402","status":"warn","finding":"no-store not verified"},{"fix":"include EIP-712 domain extra { name: 'USD Coin', version: '2' } when your facilitator/client expects it","check":"usdc_eip712_domain","status":"warn","finding":"extra.name/version not exposed"}]}},"exampleRequest":{"url":"https://example-api.service.com/v1/data/premium","method":"GET","resource":"premium_dataset","budget_usdc":5},"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6np97BP6_w3JcEuCihfiJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes an x402 payment-gated URL and returns a pay/avoid/cap verdict with live 402 probe results, hosted graph evidence, examples, and exact autopay stop conditions.","exampleAgentPrompt":"Before I let you autopay this endpoint, run a risk preflight on https://some-service.example.com/v1/paid-route and tell me whether I should pay, avoid, or cap it — and what the exact conditions are where you'd stop autopaying.","exampleUseCases":null,"resultDescription":"Returns a structured verdict (pay / avoid / cap) for the submitted x402 URL, including results of a live 402 probe against the endpoint, graph-based evidence from hosted observations, comparable example endpoints, and precise conditions under which autopay should be halted.","failureModes":["Invalid or non-x402 URL submitted — returns error indicating URL is not a valid x402 resource","Target endpoint unreachable during live probe — returns partial result with probe failure noted","Insufficient graph data for the endpoint — verdict returned with low-confidence flag","Payment of 0.20 USDC on Base not settled — request rejected with 402 response","Malformed request body — returns 400 validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to decide whether to autonomously pay an x402-gated API before committing funds — especially for unknown or new endpoints. Prefer this over generic trust checks when you need a structured pay/avoid/cap verdict backed by live probe data and historical graph evidence specific to the x402 ecosystem.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:27.047Z","isFirstParty":false}