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"
}
Score
Get Credit Score
Get the credit score for a single Ethereum address
GET
/
api
/
v2
/
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 excellentstring
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"
}