Six agent-payable APIs at $0.10 per call
Every paid endpoint speaks x402 v2 on XRPL mainnet. XRP or RLUSD; either works. No API key, no account, no subscription. Pay per call. Treasury, facilitator, and settlement are all on-chain and verifiable. The free dashboards on this site are powered by the free endpoints listed below; the deep dives are paid.
POST /scan
Behavioral classification for any XRPL address. Returns an activity-level tier, signal flags, watchlist labels, DID credentials when present, and a 30-day behavior summary. Pattern detection over public ledger data; no risk score, no AML verdict.
POST /events/recent
Six streams in one time-ordered feed: regulatory and central-bank news, on-chain whale activity, XLS-70/80/81 permissioned-domain events, Sentinel state-changes, real-world-asset mints and burns, and DID credentials. Every event carries source provenance.
POST /scan
XRPL macro snapshot in one call. Total and dormant supply, escrowed and AMM-locked XRP, regional liquidity, settlement volume (permissioned vs open-market), ETF-custody XRP from Flows, and an implied price-floor calculator with an ETF-flow-biased side-by-side.
Permissioned-domain directory and explorer. Drill into a domain for credentials, issuers, lifecycle, identity, and on-chain trading activity. Scan by domain ID or owner address. Operator rollups across domains, subjects, and 24h activity. Browsing the directory is free; drill-downs are paid.
POST /scan
Per-issuer deep dive for any real-world asset on XRPL. Lookup by wallet, label, or currency. Returns circulating supply, 24h mint and burn flow, AMM pool exposure, token-escrow activity, deep-freeze events, and an XLS-80 fingerprint if the issuer also operates a permissioned domain. Native units only; no fabricated USD.
POST /scan
Per-ETF deep dive for every US-listed XRP-exposure fund (six spot, six indirect-basket). Latest AUM, daily history, XRP-attributable slice math, SEC EDGAR filings, and the on-chain exchange-flow context from Pulse for the same window. New launches auto-discovered from the SEC ticker index.
Call the endpoint. The server returns HTTP 402 with two payment options: an XRP amount and an equivalent RLUSD amount. Each carries the exact drops/units, the destination address, an invoice ID, and the t54 facilitator URL. Quotes are good for 10 minutes.
Pick XRP or RLUSD. Sign an XRPL Payment matching that requirement, base64-encode the JSON envelope, and re-send the original request with the envelope in the PAYMENT-SIGNATURE header. The server verifies the signature before doing any work.
On verified payment the server builds the response, then settles via the t54 facilitator and attaches a PAYMENT-RESPONSE header containing the on-chain transaction hash. No charge if the work fails; no work if the payment is invalid.
The x402-xrpl package on PyPI wraps the whole flow into a normal HTTP session.
pip install x402-xrpl
from x402_xrpl import X402RequestsSession
from xrpl.wallet import Wallet
session = X402RequestsSession(
wallet=Wallet.from_seed(seed),
rpc_url="https://YOUR_XRPL_RPC",
payment_requirements_selector="XRP",
)
r = session.post(
"https://sentinel.xrpl-utilities.io/scan",
json={"address": "rExample..."},
).json()
Every paid endpoint is also exposed as an MCP tool. Wire it into Claude Desktop or any MCP host and the agent pays per call through its own configured XRPL wallet.
npm install -g @xrpl-utilities/mcp # or use the hosted endpoint: # mcp.xrpl-utilities.io/mcp # Tools published: # xrpl_sentinel_scan # xrpl_pulse_recent_events # xrpl_telemetry_scan # xrpl_trust_scan # xrpl_vault_scan # xrpl_flows_scan
Aggregate stats, manifests, and health probes are free and unauthenticated. The paid endpoints are the per-call deep dives; the free ones are the rolled-up views. Both are served from the same backends.
/stats/whale-flow-24h · institutional and whale tier hourly buckets, last 24h/stats/whale-flow-history · daily rollup of whale flow, trailing N days or explicit window/stats/rwa-summary · cross-issuer RWA snapshot/stats/exchange-flow-delta · daily net XRP exchange flow/stats/correlation · daily ETF AUM vs XRPL exchange-flow series + rolling Pearson/stats/launch-impact · pre/post-launch whale-flow envelope per ETF/stats/etf-aggregate-xrp-held · total XRP under ETF custody (direct + attributable)/stats/etf-candidates · auto-discovered XRP-ETF candidates from SEC index/domains · live XLS-80 permissioned domain directory/credentials/issuers · aggregated credential-issuer registry/jurisdictions · per-country rollup of operators and issuers/events · XLS-70/80/81 lifecycle event stream/stats/daily-flow · cross-issuer settlement events and USD-pegged net flow per day/agents.json · machine-readable manifest with capabilities, payment terms, and endpoint catalog/schema · full response shape per endpoint/healthz · liveness probe with subsystem status/docs · interactive Swagger UI/llms.txt · LLM-friendly summary of the serviceOn-chain data passthrough only. No editorial scoring, no compliance verdicts, no investment advice. Per-call price is pinned in XRP drops and refreshed when spot moves substantially; the 402 response always advertises the exact required amount for that call. See Terms for the full disclaimer.