{"uid":"cap__0TlLUQ2SqrsvzQ5KrCdf","slug":"x402-endpoint-preflight-safety-check-a25be4ba","name":"x402 Endpoint Preflight Safety Check","description":"Preflight before paying any x402 endpoint: validates its 402 challenge (network, amount, asset, payTo, timeout, Bazaar declaration), prices it in USD, screens the payTo wallet (OFAC, wallet vs token contract) and shows real usage (Bazaar 30-day calls and unique payers). Budget check with max_price_usd. ok_to_pay / caution / do_not_pay. $0.003 USDC per call.","url":"https://x402-agent-api.onrender.com/api/v1/x402-preflight?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The paid endpoint, e.g. https://api.example.com/v1/tool."},"via":{"type":"string","maxLength":64,"description":"Optional: the tool whose next_calls suggested this call (filled in for you)."},"method":{"enum":["auto","GET","POST"],"type":"string","default":"auto","description":"How to request it: auto (default) tries GET, then POST with an empty JSON body."},"max_price_usd":{"type":"number","description":"Your budget per call: a higher price makes the verdict do_not_pay.","exclusiveMinimum":0}}},"responseSchema":{"type":"json","example":{"url":"https://x402-agent-api.onrender.com/api/v1/email-verify","usage":{"calls_30d":340,"index_size":32305,"last_called_at":"2026-10-12T05:00:00.000Z","seller_listings":22,"listed_on_bazaar":true,"seller_calls_30d":900,"unique_payers_30d":12},"pay_to":{"address":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC","verdict":"no_flags","sanctioned":false,"account_type":"wallet","transactions_sent":12},"reasons":[{"code":"established","message":"12 different wallets paid it in the last 30 days (340 calls).","severity":"info"}],"verdict":"ok_to_pay","challenge":{"found":true,"method":"GET","status":402,"options":[{"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000","pay_to":"0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC","scheme":"exact","network":"eip155:8453","testnet":false,"problems":[],"price_usd":0.001,"network_label":"Base","max_timeout_seconds":300}],"description":"Is this email address real and safe to send to?","response_ms":420,"cheapest_usd":0.001,"x402_version":2,"bazaar_declaration":"valid"},"disclaimer":"Checks what can be seen without paying; it cannot prove the paid response will be good. Not financial or legal advice.","next_calls":[]}},"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_yNdIsTg20-UvnjwhB5ChC","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":"Checks whether an x402 paid endpoint is safe to call before spending USDC, returning a pay/no-pay verdict with wallet sanction status, usage history, and pricing details.","exampleAgentPrompt":"Before my agent pays that x402 endpoint at https://api.example.com/v1/tool, run a preflight check on it — I want to know if the wallet is sanctioned, how many other wallets have paid it, and whether it's safe to pay with a budget of $0.01 per call.","exampleUseCases":[{"title":"Vet unknown x402 endpoint before payment","prompt":"I found an x402 endpoint at https://some-new-api.com/v1/data-tool — can you preflight it and tell me if the pay-to wallet is clean, how much it costs, and whether it's safe to pay? My max budget is $0.05 per call."},{"title":"Automated agent payment safety gate","prompt":"My agent is about to pay an x402 endpoint at https://third-party-service.io/api/analyze — check if it's safe first, whether the wallet has ever been paid by other users, and if the price is within $0.02."},{"title":"Audit x402 endpoint in research pipeline","prompt":"I'm building a pipeline that pays multiple x402 APIs — can you run a preflight on https://data-provider.xyz/v1/fetch to confirm the wallet isn't OFAC-sanctioned and see its 30-day usage stats before I wire anything?"}],"resultDescription":"Returns a JSON object with a top-level verdict (ok_to_pay or do_not_pay), the pay-to wallet address with its own sanction/flags verdict, 30-day usage stats (calls, unique payers, bazaar listing status), parsed x402 challenge details (price in USD, network, asset, scheme), and an array of reason objects explaining the verdict with severity levels. Also includes a disclaimer and any suggested next calls.","failureModes":["Target endpoint does not respond or returns non-402 status — challenge.found is false","Endpoint wallet address is OFAC-sanctioned — verdict is do_not_pay with sanctioned:true","Price exceeds max_price_usd budget — verdict is do_not_pay with budget reason","Malformed or invalid URL input — validation error returned","Target endpoint is slow to respond — response may time out","No usage history exists — usage stats will show zeros, lower confidence verdict"],"whenToPreferThis":"Use this endpoint whenever an AI agent is about to autonomously pay an unknown or third-party x402 endpoint with USDC, and you need a pre-payment safety gate. It is uniquely suited for x402-specific due diligence — combining OFAC/sanction checks on the payment wallet, real-world usage statistics from the bazaar, and parsed challenge metadata — in a single call. Prefer it over general crypto wallet checkers when you specifically need x402 protocol context (challenge parsing, bazaar listing verification, price-in-USD assessment).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:44:15.157Z","isFirstParty":false,"canonicalSlug":"x402-endpoint-preflight-safety-check-a25be4ba"}