Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
score
/
address
/
{address}
curl -X GET "https://api.credprotocol.com/api/v2/score/address/vitalik.eth" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

​
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

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

​
Response

​
address
string
The resolved Ethereum address (checksummed)
​
score
integer
Credit score between 300 and 1000
​
decile
integer
Score decile from 1 to 10
​
range
string
Score range: low, fair, good, very_good, or excellent
​
model_version
string
The scoring model version (currently andromeda_1.0)
​
timestamp
string
ISO 8601 timestamp when the score was calculated
​
factors
array
Optional array of score factors (when include_factors=true). Each factor includes label, rating, and description.

​
Score Ranges

Score RangeRangeDescription
920-1000ExcellentExceptional on-chain activity and credit history
840-919Very GoodStrong creditworthiness indicators
750-839GoodSolid on-chain history
640-749FairSome positive activity, room for improvement
300-639LowLimited 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"

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