{"uid":"cap_bADv7YUEjmYSkl6M2nvtP","slug":"x402-endpoint-buyer-preflight-cd990351","name":"x402 Endpoint Buyer Preflight","description":"Verify and lint a third-party x402 endpoint without paying it. Probe the live HTTP 402 challenge, validate x402 v2 and Base payment requirements, and check exact Coinbase Bazaar and 402index listing evidence before a buyer authorizes payment.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/x402_endpoint_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":"Public HTTP or HTTPS endpoint to inspect without paying."},"method":{"type":"string","description":"GET, HEAD, or POST. Defaults to GET."},"request_body":{"type":"object","description":"Optional JSON body for a POST probe. Payment credentials are never forwarded."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","ready_for_payment","decision","payment_requirements","discovery"],"properties":{"success":{"type":"boolean"},"decision":{"type":"string"},"discovery":{"type":"object","required":["coinbase_bazaar"],"properties":{"coinbase_bazaar":{"type":"object","required":["checked","exact_match_count"],"properties":{"checked":{"type":"boolean"},"exact_match_count":{"type":"integer"}},"additionalProperties":true}},"additionalProperties":true},"ready_for_payment":{"type":"boolean"},"payment_requirements":{"type":"array","items":{}}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"success":true,"decision":"payment_challenge_is_structurally_ready","discovery":{"coinbase_bazaar":{"checked":true,"exact_match_count":1}},"ready_for_payment":true,"payment_requirements":[]}},"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_SscxZpbnMcZB6tttOAOSt","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":"Probe a live x402-protected endpoint to validate its HTTP 402 challenge, payment requirements, and marketplace listing before authorizing payment.","exampleAgentPrompt":"Before I pay anything, probe https://api.example.com/some-paid-endpoint with a GET request and tell me if its x402 v2 challenge is valid, whether it requires Base network USDC, and if it's actually listed on Coinbase Bazaar or 402index.","exampleUseCases":[{"title":"Validate x402 API before agent payment","prompt":"I found an x402 API at https://some-marketplace-api.com/data and I want to make sure it's legit before my agent pays for it — can you probe it with a GET request and tell me if the 402 challenge is valid, what payment it requires, and whether it shows up on Coinbase Bazaar?"},{"title":"Lint third-party endpoint for v2 compliance","prompt":"Can you check if https://thirdparty-api.io/premium-endpoint is properly x402 v2 compliant and accepts Base network USDC payments? Use a POST probe with an empty body and flag any issues before I whitelist it for my agent."},{"title":"Confirm 402index listing before budget approval","prompt":"Before I approve budget for my agent to call https://data-vendor.xyz/api/feed, probe it with a GET and confirm it's actually listed on 402index — I only want to authorize payment to endpoints with verified marketplace listings."}],"resultDescription":"Returns the parsed HTTP 402 challenge headers and body, x402 v2 protocol conformance results, Base network payment requirement details (token, amount, recipient), Coinbase Bazaar listing evidence, 402index listing presence, and any lint warnings or validation errors — all without forwarding payment credentials or executing a transaction.","failureModes":["Target endpoint is not reachable or returns non-402 status — validation cannot proceed","Endpoint returns a 402 but with malformed or missing x-payment-required headers — lint errors reported","Endpoint is not listed on Coinbase Bazaar or 402index — listing evidence returns negative","Network timeout when probing the live endpoint","Request body forwarding rejected because it contains payment credentials — stripped and flagged","Endpoint requires a payment method other than Base USDC — flagged as incompatible"],"whenToPreferThis":"Use this endpoint when an AI agent or buyer needs to vet an unknown or third-party x402-protected API before authorizing any payment. It is the correct choice when you need zero-cost pre-authorization verification, x402 v2 protocol linting, Base network compatibility checking, or marketplace listing confirmation. Prefer this over blindly calling a paid endpoint or over general HTTP inspection tools that lack x402-specific validation logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T00:42:54.153Z","isFirstParty":false,"canonicalSlug":"x402-endpoint-buyer-preflight-cd990351"}