{"uid":"cap__9GCW3B9kcGHveBKM0ipy","slug":"agent-weather-xrpl-x402-merchant-pre-flight-check-8f3749b8","name":"Agent Weather XRPL x402 Merchant Pre-flight Check","description":"Use when you want pre-flight measurements of an XRPL x402 payee before paying it. Facts about one XRPL x402 payee (GET /v1/merchant/{r-address}): account age, first funder and Domain field, payments and unique payers in the last 24h from our own ledger scan, payer concentration (HHI, top-payer share), heuristic automated-cluster share, payer creation batches, funding links between payers and the merchant, timing regularity, amount distribution, endpoint liveness and valid 402 from one unpaid GET, and a 0-100 composite index (a measurement, not advice) with every component and its method shown. Directory listing is reported as unknown. Invalid addresses are rejected with 400 before any payment. JSON, precomputed every 30 min for active payees. Example (illustrative): GET /v1/merchant/rnFHPGmgTLSg7hjzfr8wiHaTdTh3PijrZZ → {account_age_days, payments_24h, payer_concentration, score, components[]}. Price: 0.03 RLUSD on XRPL mainnet (xrpl:0; RLUSD issuer rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De) or 0.03 USDC on Base.","url":"https://api.agentweather.io/v1/merchant/:address?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"},"pathParams":{"type":"object","properties":{"address":{"type":"string","description":"XRPL classic address (r...) of the payee to report on"}}},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["example_data","schema_version","report_id","issued_at","merchant","sources","data_gaps","methodology"],"properties":{"sources":{"type":"array"},"merchant":{"type":"object"},"data_gaps":{"type":"array"},"issued_at":{"type":"string","format":"date-time"},"report_id":{"type":"string"},"methodology":{"type":"object"},"example_data":{"const":false},"schema_version":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O4LxynVty0sRaqnfZIr2f","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a pre-payment risk and liveness profile for a single XRPL x402 payee address, including account age, payment history, payer concentration, automation heuristics, and a 0-100 composite score.","exampleAgentPrompt":"Before my agent pays that x402 merchant at rNHJi9dGbhJPwH5LbdXfUJbEJb7G7J9BcQ, run a pre-flight check on Agent Weather — I want to see its account age, 24-hour payment volume, payer concentration, whether the endpoint is live with a valid 402, and its composite risk score.","exampleUseCases":[{"title":"Pre-payment due diligence on new payee","prompt":"I'm about to let my agent pay the x402 merchant at rnFHPGmgTLSg7hjzfr8wiHaTdTh3PijrZZ — can you pull its Agent Weather profile first so I can see the account age, payer concentration HHI, and composite risk score before we send anything?"},{"title":"Detecting bot-driven or fake merchant traffic","prompt":"This XRPL merchant address rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De has been showing up in our payment queue — what does Agent Weather say about the automated-cluster share and payer creation batch patterns for it?"},{"title":"Verifying x402 endpoint liveness before automation","prompt":"Before I wire up my agent pipeline to automatically pay that x402 endpoint, check whether rnFHPGmgTLSg7hjzfr8wiHaTdTh3PijrZZ is actually live, returning a valid 402, and has a decent score on Agent Weather."}],"resultDescription":"A JSON object containing: account age in days, first funder identity and domain field, 24-hour payment count and unique payer count, payer concentration metrics (HHI and top-payer share), heuristic automated-cluster share percentage, payer creation batch signals, funding links between payers and merchant, payment timing regularity, amount distribution statistics, endpoint liveness status, valid 402 response confirmation, and a 0-100 composite index with all component scores and their calculation methods shown. Data is precomputed every 30 minutes for active payees.","failureModes":["Invalid XRPL r-address returns HTTP 400 before any payment is attempted","Directory listing or non-merchant address reported as unknown/unscored","Inactive or brand-new payees may not have precomputed data (cold cache)","Score components may be incomplete if the address has very few transactions in 24h","x402 payment of 0.03 RLUSD must succeed on XRPL mainnet to retrieve data"],"whenToPreferThis":"Use this endpoint when an AI agent needs to autonomously decide whether to pay an unknown XRPL x402 merchant — it provides structured, pre-computed risk signals specifically designed for agent pre-flight decision-making. Prefer it over generic blockchain explorers when you need payer concentration analysis, automation heuristics, endpoint liveness, and a single composite score in one call optimized for x402 payment flows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T00:43:13.120Z","isFirstParty":false,"canonicalSlug":"agent-weather-xrpl-x402-merchant-pre-flight-check-8f3749b8"}