---
title: "Get AI-driven crypto trust score for a wallet address"
method: POST
path: "/users/credit-score"
tags: ["Credit Score API"]
---

# Get AI-driven crypto trust score for a wallet address

`POST /users/credit-score`

Returns an AI-driven crypto trust score (1–9) for any wallet address, combining on-chain inflow/outflow analysis, fraud probability, and social graph signals. Designed for DeFi lending protocols that need to differentiate reliable borrowers from high-risk wallets before originating loans — without requiring identity data.

**Response latency:** under 100ms.

**Subscription:** Enterprise.

**Supported networks:** `ETH`, `BNB`, `POLYGON`, `TON`, `BASE`, `HAQQ`.

**Further reading:** [Credit Score Guide](https://chainaware.ai/blog/chainaware-credit-score-the-complete-guide-to-web3-credit-scoring-in-2026/)

## Request body

- CreditScoreRequestBody
  - `network` 'ETH', required — Blockchain network to query.
  - `walletAddress` string, required — The wallet address to score.

## Response `200`

Credit score result

- CreditScoreResponse
  - `message` string — Result status message.
  - `creditData` object
    - `walletAddress` string — The queried wallet address.
    - `riskRating` integer — AI-driven crypto trust score from 1 (lowest trust) to 9 (highest trust). Combines on-chain inflow/outflow analysis, fraud probability, and social graph signals. Score guidance: 8–9 high trust, 6–7 above average, 4–5 average, 2–3 below average, 1 low trust.

## Other responses

- `400` — Bad request — missing or invalid fields in the request body
- `401` — Unauthorised — API key missing or invalid
- `404` — Wallet not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/chainaware/apis/chainaware-enterprise-api.md) · [All operations](https://skmtc.dev/chainaware/apis/chainaware-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chainaware/chainaware-enterprise-api/revisions/a045ee3672fc/schema)