{"uid":"cap_TVevUyy0o7YlyCLHQe0_g","slug":"paddock-pre-payment-endpoint-verification-630e5c4b","name":"Paddock Pre-Payment Endpoint Verification","description":"Paddock pre-payment endpoint verification — one-time query","url":"https://paddock.finance/api/paddock/mcp/verify-before-pay?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"pay_to":{"type":"string"},"endpoint_url":{"type":"string"},"expect_asset":{"type":"string"},"expect_seller":{"type":"string"},"expect_network":{"type":"string"},"expect_price_usdc":{"type":"number","minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","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.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_d8IyBn8lTUd23yzo0FL94","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies an x402-payment endpoint before paying — checks that the payment details (seller, asset, network, price) match what you expect.","exampleAgentPrompt":"Before I pay for this API call, can you verify the endpoint https://api.example.com/some-service to make sure the seller is 0xABC123, the price is exactly $0.10 USDC, and the network is base-mainnet?","exampleUseCases":[{"title":"Pre-payment safety check for agent","prompt":"Before my agent pays that Paddock niche-gap-analysis endpoint, verify that the pay_to address is 0xSELLERADDRESS, the price is $0.25 USDC, the asset is USDC, and the network is base — I don't want it sending money to the wrong place."},{"title":"Validating advertised price vs. actual","prompt":"Can you check the endpoint at https://paddock.finance/api/paddock/mcp/best-value-providers and confirm the price is exactly $0.25 USDC and the seller matches the one listed on the marketplace before we proceed?"},{"title":"Fraud prevention before micropayment","prompt":"I'm about to call a paid AI data API — please verify its payment endpoint URL first and make sure the expected seller address, asset type, and network all match what was advertised so we know it's legitimate."}],"resultDescription":"Returns a structured JSON object indicating whether the endpoint's actual payment parameters (seller address, asset, network, price) match the expected values provided in the query — effectively a pass/fail pre-flight verification with detail on any mismatches.","failureModes":["Endpoint URL unreachable — returns error if the target API is down or returns no 402 payment header","Mismatch detected — returns a negative result if any expected field (price, seller, asset, network) doesn't match","Invalid query parameters — missing required fields like endpoint_url or method returns a 400-style error","Non-x402 endpoint — if the target endpoint doesn't support x402 payment headers, verification cannot proceed","Network timeout — slow or unresponsive target endpoints may cause the verification call to time out"],"whenToPreferThis":"Use this endpoint when an AI agent is about to make a micropayment via the x402 protocol and needs to confirm the payment details (seller, price, asset, network) before committing funds. It is especially valuable for fraud prevention, ensuring advertised prices match reality, and building trust in automated agent payment pipelines. Prefer this over blindly calling a paid endpoint when the payment destination is not fully trusted or when the price must be confirmed programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:32:24.304Z","isFirstParty":false,"canonicalSlug":"paddock-pre-payment-endpoint-verification-630e5c4b"}