# Agent Weather x402 Health Report

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

Returns a full health report for known XRPL x402 endpoints: liveness, valid-402 status, price/payTo drift, catalog reachability, and t54 facilitator health.

## Facts

- Endpoint: GET https://api.agentweather.io/v1/health/report?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-weather-x402-health-report-5d703093
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E3u27nWXMHISVgsCes7Mq

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-x402-health-report-5d703093
```

Example prompt: Pull the latest x402 health report for all known XRPL endpoints — I want to see which ones are live, which have drifted in price or payTo address, and whether the t54 facilitator is healthy before I start sending payments.

## When to prefer this

Use this endpoint when you need a comprehensive, aggregated view of the entire XRPL x402 ecosystem health before initiating payments — covering liveness, drift detection, and facilitator status in a single call. Prefer it over probing individual endpoints yourself when you want pre-validated 402 status, multi-endpoint drift history, and facilitator health together. Not suited for deep per-endpoint payment analytics (use the x402-activity endpoint for that) or for non-XRPL payment rails.

## Known failure modes

- Payment required (402) if x402 payment header not provided — endpoint itself is paywalled at $0.01 USDC
- Stale data if probed endpoints were unreachable during the last 20-minute cycle
- Partial results if some merchant /.well-known/x402 catalogs were unreachable
- Facilitator health may show incomplete data if t54 ledger scan had gaps
- Response may be truncated if upstream endpoints timed out during the probe cycle

## How this service works

Use when you need pre-flight readings of liveness, valid-402 status and price/payTo drift for known XRPL x402 endpoints. Health of known x402 endpoints on XRPL and of the t54 facilitator: per-endpoint liveness and valid-402 check from one unpaid GET every 20 min (merchants' own /.well-known/x402 catalogs plus endpoints we discovered), price, asset, network and payTo drift versus the previous check, catalog reachability, and facilitator health from /supported reachability and our own ledger scan (success rate, fee spikes, tagged volume). JSON with sources and data gaps. Example (illustrative): GET /v1/health/report → {endpoints:[{url, status, valid_402, ms}], drift[], facilitator}. Price: 0.01 RLUSD on XRPL mainnet (xrpl:0; RLUSD issuer rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De) or 0.01 USDC on Base. Terms: https://api.agentweather.io/v1/terms

## Output

A JSON health report containing: a list of probed x402 endpoints with liveness status, HTTP status code, valid_402 flag, and latency; drift events (price, rail, payTo changes vs previous cycle); merchant catalog reachability; t54 facilitator health (reachability, on-ledger success rate, fee and tagged volume status); metadata including cycle number, timestamps, sources, and data gaps.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "drift": {
   "recent": [
    {
     "at": "2026-10-12T02:31:29.381Z",
     "to": "356",
     "url": "https://x402.n9t2.com/rpc",
     "from": "355",
     "kind": "price",
     "rail": "xrpl:0|XRP|",
     "cycle": 516
    },
    {
     "at": "2026-10-12T02:31:29.381Z",
     "url": "https://api.agentweather.io/v1/agent-weather/x402-activity",
     "kind": "rail_added",
     "rail": "eip155:8453|0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913|",
     "cycle": 516,
     "amount": "10000"
    }
   ],
   "this_cycle": [
    {
     "to": "356",
     "url": "https://x402.n9t2.com/rpc",
     "from": "355",
     "kind": "price",
     "rail": "xrpl:0|XRP|"
    },
    {
     "url": "https://api.agentweather.io/v1/agent-weather/x402-activity",
     "kind": "rail_added",
     "rail": "eip155:8453|0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913|",
     "amount": "10000"
    }
   ]
  },
  "sources": [
   {
    "url": "https://api.agentweather.io/v1/methodology#health",
    "name": "Agent Weather health checker: one unpaid GET per known x402 endpoint and merchant /.well-known/x402 per cycle",
    "observed_at": "2026-10-12T02:31:29.366Z"
   }
  ],
  "data_gaps": [
   {
    "gap": "facilitator settlement latency",
    "reason": "not observable on-ledger; only our own sales' claim->settle time is shown (small sample)"
   }
  ],
  "endpoints": {
   "cycle": 516,
   "probed": 77,
   "results": [
    {
     "ms": 32,
     "url": "https://agent-commerce.emergedigital.com/api/xrpl/llms-txt-generate",
     "http": 402,
     "rails": [
      {
       "asset": "XRP",
       "amount": "900000",
       "pay_to": "rERHPAkbSH8bEHYJWKDERJJ9meDab8Zb1N",
       "network": "xrpl:0"
      },
      {
       "asset": "RLUSD",
       "amount": "1",
       "pay_to": "rERHPAkbSH8bEHYJWKDERJJ9meDab8Zb1N",
       "network": "xrpl:0"
      }
     ],
     "status": "live_402",
     "valid_402": true
    }
   ],
   "catalogs": [],
   "checked_to": "2026-10-12T02:31:29.366Z",
   "broken_share": 0.104,
   "checked_from": "2026-10-12T02:31:03.519Z",
   "status_counts": {
    "live_402": 58,
    "not_found": 6,
    "invalid_402": 1,
    "client_error": 1,
    "server_error": 1,
    "live_200_no_payment": 1,
    "live_402_testnet_only": 1,
    "live_405_get_not_allowed": 8
   }
  },
  "issued_at": "2026-10-12T02:34:12.090Z",
  "report_id": "awh-2026-10-12T0234Z",
  "facilitator": {
   "ok": true,
   "level": "ok",
   "reasons": [
    "t54 reachable; on-ledger success rate, fees an
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-weather-x402-health-report-5d703093/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)
