# Agent Weather x402 Activity on XRPL > Agent Weather x402 Activity on XRPL 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 x402 payment activity statistics on XRPL mainnet including volume, payer/merchant counts, and real-vs-automated traffic analysis for 1h/24h/7d windows ## Facts - Endpoint: GET https://api.agentweather.io/v1/agent-weather/x402-activity?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-activity-on-xrpl-9a0e02fe - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_prg4Hc1v_cfJ3I-yaME8B 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-activity-on-xrpl-9a0e02fe ``` Example prompt: What's the x402 payment activity on XRPL mainnet right now — total volume, number of unique payers and merchants, and how much of it looks like real organic traffic vs automated bots, for the last 24 hours? ## When to prefer this Choose this endpoint when you need a comprehensive, pre-aggregated analytics snapshot of x402 protocol payment activity specifically on XRPL mainnet, including bot-vs-organic classification and merchant concentration metrics. Prefer this over raw ledger queries when you want structured, heuristic-enriched reporting without building your own ledger scanner. Best for agent economy health monitoring, x402 adoption tracking, and fraud/automation detection on XRPL. ## Known failure modes - Ledger scan lag may cause incomplete data for the most recent minutes of the 1h window - Automated vs organic classifier is heuristic and may misclassify edge cases - Data gaps array may indicate incomplete coverage for certain time windows - Payment tagging relies on SourceTag 804681468; untagged x402 payments are excluded - Cache staleness up to 60 seconds may affect real-time monitoring use cases - 402 payment required if no valid x402 payment is attached to the request ## How this service works Use when you need x402 payment volume, payers and merchants on XRPL for the last 1h/24h/7d. x402 payment activity on XRPL mainnet from our own validated-ledger scan (Payments tagged with the t54 facilitator SourceTag 804681468): payments and delivered volume per asset (XRP, RLUSD, other tokens) for the last 1h / 24h / 7d, hourly and daily series, unique payers and merchants, top and new merchants, coverage window, sample transactions with explorer links, a heuristic real-vs-automated split (all / automated_cluster / organic_candidate from a payer-cluster classifier: creation batches, funding lineage, timing regularity, uniform-random amounts) with per-payee concentration (HHI, top-payer share), and explicit caveats. JSON, cached up to 60 seconds. Example (illustrative): GET /v1/agent-weather/x402-activity → {windows:{1h,24h,7d}, per_asset, unique_payers, unique_merchants}. 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 report including: payment counts and delivered volume per asset (XRP, RLUSD, other tokens) across 1h/24h/7d windows, hourly and daily time series, unique payer and merchant counts, top and newly appearing merchants, sample transactions with XRPL explorer links, a heuristic real-vs-automated traffic classification (all/automated_cluster/organic_candidate), per-payee concentration metrics (HHI, top-payer share), coverage window metadata, data gaps, and explicit methodology caveats. Cached up to 60 seconds. ## Request schema (JSON Schema) ```json { "type": "object", "properties": { "properties": { "type": "string" } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "scope": { "network": "xrpl:0", "ecosystem": "x402", "facilitator_source_tag": 804681468 }, "sources": [ { "url": "https://honeycluster.io/", "name": "XRPL mainnet validated ledgers via honeycluster.io (own ingester)", "status": "ok", "ledgers": 407753, "observed_at": "2026-10-12T02:32:41.000Z" } ], "activity": { "as_of": "2026-10-12T02:32:41.000Z", "last_24h": { "to": "2026-10-12T02:32:41.000Z", "from": "2026-10-11T02:32:41.000Z", "complete": false, "payments": 231464, "unique_payees": 104, "unique_payers": 110 }, "available": true, "computed_at": "2026-10-12T02:32:53.037Z", "real_vs_automated": { "totals": { "last_24h": { "all": { "payments": 19127, "unique_payers": 109 }, "automated_cluster": { "payments": 19127, "unique_payers": 109 }, "organic_candidate": { "payments": 0, "unique_payers": 0 } } }, "available": true, "heuristic": true, "classifier": "payer-cluster-1.0", "computed_at": "2026-10-12T02:30:48.587Z" }, "top_merchants_24h": [ { "payee": "rBi1QrVjwaNofisZAQnovoXdHkS73FG1tJ", "payments": 192186, "unique_payers": 109 } ], "ingest_lag_seconds": 91 }, "data_gaps": [ { "gap": "complete last_24h window", "reason": "contiguous coverage is 2.91h (from 2026-10-11T23:38:22.000Z)" } ], "issued_at": "2026-10-12T02:34:12.746Z", "report_id": "awx-2026-10-12T0234Z-xrpl0", "methodology": { "definitions": { "payments": { "measured": true, "definition": "count of validated Payments with SourceTag 804681468 and result tesSUCCESS whose ledger close time is in the window" } } }, "example_data": false, "schema_version": "x402-activity-0.2.0-draft" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-weather-x402-activity-on-xrpl-9a0e02fe/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)