---
title: "XRPLScore — per-call, agent-priced (x402, $0.02 USDC on Base or RLUSD on XRPL)"
method: POST
path: "/api/x402/usdc/score"
tags: ["Scoring"]
---

# XRPLScore — per-call, agent-priced (x402, $0.02 USDC on Base or RLUSD on XRPL)

`POST /api/x402/usdc/score`

## Request

- Base URL: `https://www.xrplhub.io`
- URL: `https://www.xrplhub.io/api/x402/usdc/score`
- Auth: none declared

The same 300–850 score and 8-signal breakdown as /api/x402/score, priced for agents at $0.02 per call — the same price as GET /api/x402/score — payable on either rail: USDC on Base (x402 v1, X-PAYMENT) or RLUSD on the XRP Ledger (x402 v2 via t54: PAYMENT-REQUIRED header, retry with PAYMENT-SIGNATURE; response wrapped as { data, x402 }). POST a JSON body {"wallet":"r..."}. No signup.

## Request body

- object
  - `wallet` string, required

## Response `200`

Wallet score with the 8 signals, grade and percentile.

- object
  - `wallet` string, required
  - `score` integer, required: XRPLScore, 300–850 absolute scale.
  - `grade` 'Building' | 'Fair' | 'Good' | 'Excellent' | 'Exceptional', required
  - `percentile` number
  - `signals` object, required: The 8 component scores, 0–100 each.
    - `accountAge` number
    - `txActivity` number
    - `financialHealth` number
    - `tokenEngagement` number
    - `dexActivity` number
    - `ammActivity` number
    - `securityConfig` number
    - `nftActivity` number
  - `methodology` string
  - `disclaimer` string, required: Always present. XRPLScore is informational only — NOT a FICO score, consumer report, or NRSRO rating, and not permissible for FCRA- or ECOA-governed decisions.
  - `dataCompleteness` object, required: `complete` is always true on a 200. If any XRPL call cannot be read the endpoint returns 503 (error "xrpl_unavailable", with failedCalls) and NO score — a failed read is never folded into a signal.
    - `complete` boolean
    - `unread` string[]
    - `source` string
  - `computedAt` string, date-time

## Other responses

- `402`: Payment Required — x402 challenge. Pay in USDC on Base and retry with the X-PAYMENT header.

---

[API](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions.md) · [All operations](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions/llms.txt) · [OpenAPI document](https://skmtc.dev/xrplhub/apis/xrplhub-xrplscore-and-prebuilt-xrpl-transactions/revisions/a5d4e13aff32?raw)