---
title: "XRPLScore — wallet creditworthiness score (free, unauthenticated)"
method: GET
path: "/api/score/{wallet}"
---

# XRPLScore — wallet creditworthiness score (free, unauthenticated)

`GET /api/score/{wallet}`

## Request

- Base URL: `https://www.xrplhub.io`
- URL: `https://www.xrplhub.io/api/score/{wallet}`
- Auth: none required

Get a 300–850 creditworthiness score for one XRPL wallet with the 8-signal breakdown. Free, no key, no signup. Same number the paid endpoints and the public site return.

## Path parameters

- `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

- `404`: Address is not an activated XRPL mainnet account.

---

[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)