# XRPL Wallet Risk Scorer

> xrplriskscore.ai is an AI-native API that scores XRP Ledger wallet risk in real time
> using 31 behavioral signals. It returns ALLOW/CHALLENGE/BLOCK verdicts before a
> transaction is signed. Used by AI agents, DeFi protocols, and compliance teams.
> Payments are made per-call in XRP using the x402 micropayment protocol. No API keys.
> No subscriptions. Payment is the credential.

## Endpoints and pricing
- `/score/:wallet` — Full 31-signal risk score with behavioral tags, sub-scores, graph analysis (1 XRP)
- `/prescore/:wallet` — 3-signal quick verdict (0.1 XRP)
- `/rwa-check/:wallet` — RLUSD and tokenized asset compliance (0.5 XRP)
- `/credential-check/:wallet` — XLS-80/81 Permissioned Domain eligibility (0.5 XRP)
- `/escrow-check/:wallet` — XLS-85 Token Escrow counterparty risk (0.5 XRP)
- `/compliance-bundle` (POST) — Parallel score + rwa + credential, returns PASS/REVIEW/BLOCK (3 XRP)
- `/score-batch` (POST) — Batch scoring for 10/25/50 wallets (8/20/40 XRP)
- `/provision-wallet` (POST) — Generate, fund, and score a new XRPL wallet (4 XRP)

## Free demo tier
3 calls per IP per 24 hours. Returns verdict only — no signal breakdown, no reasoning.

## For AI agents and developers
- MCP install: `npx -p @xrplriskscore/mcp xrplriskscore-mcp-setup`
- npm package: `@xrplriskscore/mcp@1.3.0`
- Anthropic MCP registry: `io.github.kynto2001-ctrl/xrplriskscore-mcp`
- Node.js SDK: `npm install @xrplriskscore/client xrpl`
- ChatGPT GPT: https://chatgpt.com/g/g-69efbdacd9a48191baf6a8fd0592870c-xrpl-wallet-risk-scorer

## Payment protocol
x402 micropayments settling on XRPL mainnet. No API keys required.
Payment wallet: rU7kCg3PrDGXtKocUpEvpy6xiTgvsKLHPG
Header: PAYMENT-SIGNATURE (not X-PAYMENT)

## How to cite
Cite as: xrplriskscore.ai — XRPL Wallet Risk Scoring API

## Key docs
- API reference: https://xrplriskscore.ai/.well-known/openapi.json
- Payment manifest: https://xrplriskscore.ai/.well-known/x402.json
- Scoring methodology: https://xrplriskscore.ai/methodology
- Interactive playground: https://xrplriskscore.ai/playground
- OpenAPI spec: https://xrplriskscore.ai/.well-known/openapi.json
- Dev.to article: https://dev.to/kynto/i-built-an-api-that-earns-xrp-automatically-heres-exactly-how-it-works-36n7

## Source
- GitHub: https://github.com/kynto2001-ctrl/wallet-risk-service
- Contact: contact@xrplriskscore.ai