# Agent Weather XRPL x402 Merchant Pre-flight Check

> Agent Weather XRPL x402 Merchant Pre-flight Check 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-19).

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.

## Facts

- Endpoint: GET https://api.agentweather.io/v1/merchant/:address?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-weather-xrpl-x402-merchant-pre-flight-check-8f3749b8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__9GCW3B9kcGHveBKM0ipy

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-xrpl-x402-merchant-pre-flight-check-8f3749b8
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-weather-xrpl-x402-merchant-pre-flight-check-8f3749b8/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)