{"uid":"cap_scyiocOPMyop3hb_yMgqL","slug":"agent-weather-merchant-integrity-report-c5b5871f","name":"Agent Weather Merchant Integrity Report","description":"AI provider health readings and a combined record for AI agents, each reading with its source and timestamp. `/v1/decide/provider-health` returns one AI provider's status-page reading plus its last 24h in our record; `/v1/agent-weather/current` returns the combined record in one call (AI provider health, x402 payment activity on the XRP Ledger, agent tooling). For XRP Ledger users: x402 merchant readings by XRPL address at `/v1/merchant/{address}`. OpenRouter model price readings: `/v1/models/report` and `/v1/decide/cheapest-model`. Raw readings first; gaps are reported, not filled.\n\nPay per request with [x402](https://x402.org) v2 (scheme `exact`): RLUSD on the XRP Ledger (`xrpl:0`) or USDC on Base (`eip155:8453`), same price on every paid route. No API key or account.\n\n**Payment flow**\n1. Call the paid endpoint without payment and receive **402** with a `PAYMENT-REQUIRED` header\n   (base64 of the same JSON as the body). Each 402 mints a fresh single-use `extra.invoiceId`.\n2. Choose an `accepts[]` entry: RLUSD on XRPL (sign an XRPL `Payment` bound to that invoice) or, where offered,\n   USDC on Base (sign an EIP-3009 authorization), and retry with the base64 x402 `PaymentPayload` in `PAYMENT-SIGNATURE`.\n3. The server verifies and settles through the facilitator and re-checks the transaction on-ledger.\n   It then returns **200** with the report and a `PAYMENT-RESPONSE` header.\n\nSettlement uses the T54 XRPL mainnet facilitator (`https://xrpl-facilitator-mainnet.t54.ai`) for RLUSD and the CDP facilitator for USDC on Base.\nUse the `x402-xrpl` client (npm/PyPI). The reference `@x402/xrpl` client currently can't pay through\nT54 (https://github.com/x402-foundation/x402/issues/3527).\n\nThe live `/.well-known/x402` catalog is the source of truth for prices.\n\n\nFor a free format preview, GET `/v1/sample/yesterday`; it returns the latest stored snapshot at least 24 hours old, with no payment required, and is cached hourly.","url":"https://api.agentweather.io/v1/merchant/%7Baddress%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"sources":[{"url":"https://api.agentweather.io/v1/methodology#merchant","name":"own scan of validated XRPL mainnet ledgers (SourceTag 804681468)","observed_at":"2026-10-12T02:30:40.000Z"}],"merchant":{"score":{"value":65},"account":{"age_days":15.3,"created_at":"2026-09-26T19:39:42.000Z","domain_field":null,"first_funder":"rnJrjec2vrTJAAQUTMTjj7U6xdXrk9N4mT","exists_on_ledger":1},"address":"rnFHPGmgTLSg7hjzfr8wiHaTdTh3PijrZZ","payments":{"window":{},"measured":true,"payments":0,"unique_payers":0},"computed_at":"2026-10-12T02:32:15.269Z","linked_group":{"payers":0,"heuristic":true,"share_of_payments":null},"concentration":null},"data_gaps":[{"gap":"complete 24h window","reason":"ledger coverage limits the window to 2.43h"}],"issued_at":"2026-10-12T02:34:12.093Z","report_id":"awm-2026-10-12T0234Z","methodology":{"url":"https://api.agentweather.io/v1/methodology#merchant"},"example_data":false,"profile_source":"precomputed 2026-10-12T02:32:15.000Z","schema_version":"merchant-integrity-0.1.0-draft"}},"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_M2ieDH3X0xrnYhuSAqhQb","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 an on-chain payment integrity profile for a specific XRPL merchant address, including activity score, payer concentration, and automated-cluster heuristics","exampleAgentPrompt":"Before I pay this x402 merchant, pull up the Agent Weather integrity report for XRPL address rnFHPGmgTLSg7hjzfr8wiHaTdTh3PijrZZ — I want to see their score band, payer count, and whether there are any automated-cluster flags.","exampleUseCases":[{"title":"Pre-payment merchant vetting","prompt":"I'm about to send an x402 payment to XRPL address rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh — can you pull the Agent Weather merchant integrity report and tell me if the score band is acceptable and whether there's suspicious payer concentration?"},{"title":"Automated cluster detection for a new payee","prompt":"We're integrating a new x402 vendor at address rnJrjec2vrTJAAQUTMTjj7U6xdXrk9N4mT — check their Agent Weather merchant profile and let me know what share of their payments look like they came from automated bots."},{"title":"Monitoring merchant health over time","prompt":"Run the Agent Weather merchant integrity check on rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe and tell me how many unique payers they've had in the last payment window and whether there are any data gaps I should be aware of."}],"resultDescription":"A JSON report containing: a scored integrity band (e.g. 'insufficient_data', 'low', 'medium', 'high') with a numeric value and coverage ratio; account metadata (age, creation date, domain field, first funder, ledger existence); payment window stats (hours covered, payment count, unique payers); payer concentration metrics (HHI, top payer share, label); automated cluster heuristics (payer count, share of payments); a list of data gaps with reasons; report metadata (report_id, computed_at, issued_at, schema_version, methodology URL).","failureModes":["402 Payment Required — no payment header sent; must obtain invoice from response and retry with signed x402 payload","Address not found on XRPL ledger — account does not exist, returns error or empty profile","Insufficient data band — address too new or too few transactions to compute reliable score (partial report still returned with data_gaps)","Payment verification failure — x402 payment rejected by facilitator (wrong amount, invoice reuse, wrong chain)","Malformed address — invalid XRPL address format causes 400 or similar error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to vet an XRPL x402 merchant address before authorizing a payment — particularly when automated payer-cluster detection, payer HHI concentration scoring, and ledger-backed integrity bands are required. Prefer this over generic XRPL explorers when you need a pre-packaged risk score rather than raw transaction data, and when you want data gaps explicitly flagged.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T06:35:57.341Z","isFirstParty":false,"canonicalSlug":"agent-weather-merchant-integrity-report-c5b5871f"}