Get Credit Score

curl -X GET "https://api.credprotocol.com/api/v2/score/address/vitalik.eth" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 847,
  "decile": 7,
  "range": "very_good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "detail": "Invalid Ethereum address format"
}

{
  "detail": "Invalid or missing API key"
}

{
  "detail": "Address not found or has no on-chain activity"
}

GET

api

score

address

{address}

curl -X GET "https://api.credprotocol.com/api/v2/score/address/vitalik.eth" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 847,
  "decile": 7,
  "range": "very_good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "detail": "Invalid Ethereum address format"
}

{
  "detail": "Invalid or missing API key"
}

{
  "detail": "Address not found or has no on-chain activity"
}

Overview

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

Scores are calculated using the Andromeda scoring model and cached for 5 minutes.

Path Parameters

string

required

Ethereum address or ENS name (e.g., vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17)

Response

string

The resolved Ethereum address (checksummed)

integer

Credit score between 300 and 1000

integer

Score decile from 1 to 10

string

Score range: low, fair, good, very_good, or excellent

string

The scoring model version (currently andromeda_1.0)

string

ISO 8601 timestamp when the score was calculated

array

Optional array of score factors (when include_factors=true). Each factor includes label, rating, and description.

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

curl -X GET "https://api.credprotocol.com/api/v2/score/address/vitalik.eth" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

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

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 847,
  "decile": 7,
  "range": "very_good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "detail": "Invalid Ethereum address format"
}

{
  "detail": "Invalid or missing API key"
}

{
  "detail": "Address not found or has no on-chain activity"
}

Authentication Aggregated Credit Score

API Reference

Score

Report

Identity

Agents

Sandbox

Overview

Path Parameters

Response

Score Ranges

Scoring Factors

​Overview

​Path Parameters

​Response

​Score Ranges

​Scoring Factors

Overview

Path Parameters

Response

Score Ranges

Scoring Factors