{"uid":"cap_ANdsIvJNlF8zxaQQvBYQR","slug":"x402-demand-provenance-check-69ac1502","name":"x402 Demand Provenance Check","description":"Deterministic provenance analysis for caller-supplied x402 payment records. Excludes duplicate transaction hashes, separates declared owner wallets from candidate external payers, measures concentration and evidence coverage, and states limitations explicitly. It does not fetch the chain or claim wallet independence.","url":"https://hermesplant.com/api/agent-services/x402-provenance/check","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"payTo":{"type":"string","description":"Optional expected Base/EVM recipient address."},"payments":{"type":"array","items":{"type":"object","required":["payer"],"properties":{"payTo":{"type":"string"},"payer":{"type":"string"},"txHash":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"},"amountUnits":{"type":"string"}}},"maxItems":500,"minItems":1},"resourceUrl":{"type":"string","format":"uri"},"ownerWallets":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Known operator wallets to exclude from external-demand candidates."}}},"responseSchema":{"type":"json","example":{"scope":{"recordSource":"caller_supplied"},"signal":"credible_candidate_pattern","status":"analyzed","metrics":{"topPayerShare":0.5,"analyzedPayments":2,"ownerFundedCalls":0,"uniqueCandidateExternalPayers":2},"service":"x402-demand-provenance","confidence":"moderate","limitations":["Caller-supplied records are not independently verified onchain."]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dFBXFxB_UBcfqVnhvplHx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes payment demand signals for x402-gated endpoints to assess credibility, detect owner-funded or artificial usage patterns, and return a confidence-scored provenance report.","exampleAgentPrompt":"Before my agent starts paying for calls to that x402 endpoint, run a demand provenance check on it — I want to know if the payment history looks credible or if it's mostly owner-funded, and give me the confidence score and top payer share.","exampleUseCases":null,"resultDescription":"Returns a JSON object with: a provenance signal label (e.g. 'credible_candidate_pattern'), overall status ('analyzed'), confidence level ('moderate', 'high', etc.), metrics including topPayerShare, analyzedPayments, ownerFundedCalls, and uniqueCandidateExternalPayers, the service name, and a limitations array noting whether records were independently verified onchain or caller-supplied.","failureModes":["Caller-supplied payment records cannot be independently verified onchain, reducing confidence","Insufficient payment history may yield low confidence or inconclusive signal","Missing or malformed scope metadata may cause analysis to fail","Payment records with fewer than a minimum threshold of payers may return limited metrics","Service unavailable errors if the hermesplant.com endpoint is down"],"whenToPreferThis":"Use this endpoint when an AI agent needs to gate consequential spend decisions on x402-priced APIs by first validating whether observed payment demand is organic and credible, rather than artificially inflated by the service owner. Prefer this over generic reputation checks when the specific concern is x402 micropayment provenance and wash-funding detection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:30.906Z","isFirstParty":false}