{"uid":"cap_qTvJrHYzypTS9lL50kDbN","slug":"settled-preflight-check-d685b8ed","name":"Settled Preflight Check","description":"Pre-spend check for one x402 endpoint in a single signed response: fresh liveness probe on both verbs, parsed quote, payability verdict (payable / malformed 402 / cannot pay on either verb / unpriced), whether the payTo exists on-chain, the seller's other endpoints and settlement integrity, the scout's real-payment delivery result, and a honeypot scan of the listing text. Returns recommendation: pay | caution | avoid, with reasons. Call it before the first payment to an unfamiliar endpoint.","url":"https://settled.tools/v1/preflight?utm_source=zero.xyz","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":["url"],"properties":{"url":{"type":"string","description":"Absolute https URL of the x402 endpoint you are about to pay"},"force":{"type":"string","description":"1 to bypass the 5-minute probe cache"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"url":"https://api.example.com/search","payee":{"seller":{"live":11,"flags":[],"endpoints":12,"settlement_integrity":{"label":"organic","score":88}},"seen_onchain":true,"usdc_balance":1840.5},"quote":{"pay_to":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","scheme":"exact","network":"eip155:8453","price_usd":0.01,"x402_version":2},"quality":{"total":76},"reasons":["live, payable on the declared verb, payee seen on-chain, no honeypot or seller flags"],"delivery":{"verified":true,"last_delivery_at":"2026-09-27T09:00:00.000Z"},"honeypot":{"flags":[],"label":"clean"},"liveness":{"status":"live","ok_count":14,"last_ok_at":"2026-09-28T15:10:00.000Z","latency_ms":412,"http_status":402,"probe_count":14},"payability":{"verdict":"payable","payable_verb":"GET","declared_verb":"GET"},"attestation":{"hash":"0x…","signer":"0x95b774e15D7DabFAd1aFc28055C24F78eBB8452A","signature":"0x…"},"recommendation":"pay"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d8PyxPIYzoIg9TJ-yO5hF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a comprehensive pre-spend safety check on an x402 endpoint before payment, returning a pay/caution/avoid recommendation with supporting evidence.","exampleAgentPrompt":"Before I pay this x402 endpoint at https://api.example.com/v1/analyze, run a full preflight safety check on it — I want to know if the seller's wallet is real, the pricing looks legitimate, and whether I should actually pay or avoid it.","exampleUseCases":[{"title":"First-payment safety check","prompt":"I've never used this x402 endpoint before — https://dataprovider.io/v1/weather — can you run a preflight check and tell me if it's safe to pay, whether the payTo address exists on-chain, and what the recommendation is?"},{"title":"Honeypot scan before agent automation","prompt":"My agent is about to start automatically paying this x402 endpoint at https://tasks.marketplace.xyz/v1/jobs in a loop — can you scan it for honeypot signals and check the seller's reputation before I let it run?"},{"title":"Vendor trust audit for new integration","prompt":"We're integrating a third-party x402 API at https://newvendor.ai/api/sentiment into our pipeline — run a full preflight on it so I can see the liveness result, quote, payability verdict, and whether the seller has other live endpoints with a clean track record."}],"resultDescription":"A structured JSON response containing: liveness probe results for both GET and HEAD verbs, a parsed payment quote with price and network details, a payability verdict (payable/malformed 402/cannot pay/unpriced), on-chain existence status of the payTo address, the seller's other endpoints and settlement integrity score, the scout's real-payment delivery result, and a honeypot scan of the listing text — all synthesized into a final recommendation of pay, caution, or avoid, with human-readable reasons.","failureModes":["Target URL is unreachable or returns non-402 response — probe fails with error status","payTo address is not a valid blockchain address — on-chain check returns invalid","Malformed 402 response from target — verdict returned as 'malformed 402'","Target endpoint has no pricing information — verdict returned as 'unpriced'","Cache hit returns stale probe result — use force=1 to bypass 5-minute cache","Target URL is missing or not an absolute https URL — request rejected with validation error"],"whenToPreferThis":"Use this endpoint as a mandatory gate before the first payment to any unfamiliar x402 endpoint, especially in autonomous agent workflows where repeated payments could be made without human oversight. Prefer it over manual inspection when you need on-chain wallet verification, honeypot scanning, seller reputation history, and a synthesized pay/caution/avoid recommendation in a single call. It is especially valuable when integrating third-party x402 APIs into automated pipelines where fraud or misconfigured endpoints could result in wasted funds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:38:44.905Z","isFirstParty":false,"canonicalSlug":"settled-preflight-check-d685b8ed"}