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.1",
"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.1",
"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.1)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.string
How completely the address’s lending events had been read when the score was computed:
complete, partial, pending or failedboolean
true when credit_events_coverage is not complete. The score may not yet reflect the address’s repayments and liquidations.Provisional Scores
The first time an address is scored, its lending history is read from the chain. For most addresses this completes within the request. For an address with a long history it can take longer, and the response is returned before it finishes:{
"score": 761,
"credit_events_coverage": "pending",
"provisional": true
}
A provisional score can be higher than the final score, because liquidations that have not been read yet are not counted. If you use scores to make credit decisions, check
provisional and retry before acting.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.1",
"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"
}