> ## Documentation Index
> Fetch the complete documentation index at: https://docs.credprotocol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Credit Score

> Get the credit score for a single Ethereum address

## Overview

Returns a credit score (300-1000) for the specified Ethereum address based on on-chain activity analysis.

<Info>
  Scores are calculated using the **Andromeda** scoring model and cached for 5 minutes.
</Info>

## Path Parameters

<ParamField path="address" type="string" required>
  Ethereum address or ENS name (e.g., `vitalik.eth` or `0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17`)
</ParamField>

## Response

<ResponseField name="address" type="string">
  The resolved Ethereum address (checksummed)
</ResponseField>

<ResponseField name="score" type="integer">
  Credit score between 300 and 1000
</ResponseField>

<ResponseField name="decile" type="integer">
  Score decile from 1 to 10
</ResponseField>

<ResponseField name="range" type="string">
  Score range: `low`, `fair`, `good`, `very_good`, or `excellent`
</ResponseField>

<ResponseField name="model_version" type="string">
  The scoring model version (currently `andromeda_1.0`)
</ResponseField>

<ResponseField name="timestamp" type="string">
  ISO 8601 timestamp when the score was calculated
</ResponseField>

<ResponseField name="factors" type="array" optional>
  Optional array of score factors (when `include_factors=true`). Each factor includes `label`, `rating`, and `description`.
</ResponseField>

## Score Ranges

| Score Range | Range     | Description                                      |
| ----------- | --------- | ------------------------------------------------ |
| 920-1000    | Excellent | Exceptional on-chain activity and credit history |
| 840-919     | Very Good | Strong creditworthiness indicators               |
| 750-839     | Good      | Solid on-chain history                           |
| 640-749     | Fair      | Some positive activity, room for improvement     |
| 300-639     | Low       | Limited on-chain history or high-risk activity   |

## Scoring Factors

The Andromeda model considers:

* **Wallet Age**: How long the address has been active
* **Transaction History**: Volume and frequency of transactions
* **DeFi Activity**: Lending, borrowing, and liquidity provision
* **Asset Holdings**: Token and NFT portfolio value
* **Repayment History**: DeFi loan repayments and liquidations

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.credprotocol.com/api/v2/score/address/vitalik.eth" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.credprotocol.com/api/v2/score/address/vitalik.eth', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });

  const data = await response.json();
  console.log(data.score); // 847
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.credprotocol.com/api/v2/score/address/vitalik.eth',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  data = response.json()
  print(data['score'])  # 847
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "score": 847,
    "decile": 7,
    "range": "very_good",
    "model_version": "andromeda_1.0",
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```

  ```json 400 theme={null}
  {
    "detail": "Invalid Ethereum address format"
  }
  ```

  ```json 401 theme={null}
  {
    "detail": "Invalid or missing API key"
  }
  ```

  ```json 404 theme={null}
  {
    "detail": "Address not found or has no on-chain activity"
  }
  ```
</ResponseExample>