# Agent Weather Merchant Integrity Report

> Agent Weather Merchant Integrity Report is a paid API for AI agents from api.agentweather.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-20).

Returns an on-chain payment integrity profile for a specific XRPL merchant address, including activity score, payer concentration, and automated-cluster heuristics

## Facts

- Endpoint: GET https://api.agentweather.io/v1/merchant/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-weather-merchant-integrity-report-c5b5871f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_scyiocOPMyop3hb_yMgqL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-weather-merchant-integrity-report-c5b5871f
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

Pay 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.

**Payment flow**
1. Call the paid endpoint without payment and receive **402** with a `PAYMENT-REQUIRED` header
   (base64 of the same JSON as the body). Each 402 mints a fresh single-use `extra.invoiceId`.
2. Choose an `accepts[]` entry: RLUSD on XRPL (sign an XRPL `Payment` bound to that invoice) or, where offered,
   USDC on Base (sign an EIP-3009 authorization), and retry with the base64 x402 `PaymentPayload` in `PAYMENT-SIGNATURE`.
3. The server verifies and settles through the facilitator and re-checks the transaction on-ledger.
   It then returns **200** with the report and a `PAYMENT-RESPONSE` header.

Settlement uses the T54 XRPL mainnet facilitator (`https://xrpl-facilitator-mainnet.t54.ai`) for RLUSD and the CDP facilitator for USDC on Base.
Use the `x402-xrpl` client (npm/PyPI). The reference `@x402/xrpl` client currently can't pay through
T54 (https://github.com/x402-foundation/x402/issues/3527).

The live `/.well-known/x402` catalog is the source of truth for prices.


For 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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-weather-merchant-integrity-report-c5b5871f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentweather.io](https://www.zero.xyz/host/api.agentweather.io/llms.txt)