Developers
First Score in 2 Minutes
Three steps. One API call. Full 10-factor score for any autonomous entity.
Get your API key
Sign up at skoor.ai/get-started to get a free API key. Free tier includes 100 calls per day with no credit card required.
# Your key looks like this:
sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Score an entity
cURL
curl -s \
-H "X-API-Key: sk_live_YOUR_KEY" \
"https://api.skoor.ai/v1/public/credit-score/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
TypeScript
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
const res = await fetch(
`https://api.skoor.ai/v1/public/credit-score/${address}`,
{ headers: { "X-API-Key": "sk_live_YOUR_KEY" } }
);
const { score, tier, components, reasons } = await res.json();
// score: 742, tier: "excellent"
// components: { paymentHistory: 88, accountLongevity: 75, ... }
Python
import requests
address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
r = requests.get(
f"https://api.skoor.ai/v1/public/credit-score/{address}",
headers={"X-API-Key": "sk_live_YOUR_KEY"}
)
data = r.json()
print(data["score"]) # 742
print(data["tier"]) # "excellent"
Use the response
The API returns a JSON object with the overall score, tier, 10-factor component scores, and human-readable reason codes.
{
"agentId": "0xd8dA6BF26...96045",
"score": 742,
"tier": "excellent",
"components": {
"paymentHistory": 88,
"accountLongevity": 75,
"compliancePosture": 92,
"transactionVolume": 68,
"networkDiversity": 71,
"behavioralIntegrity": 85,
"communityTrust": 63
},
"reasons": [
"Strong payment history (88/100)",
"Excellent compliance posture"
]
}
Response fields
scorenumberOverall score (300-850)tierstringpoor | fair | good | excellent | exceptionalcomponentsobject7 factor scores (0-100 each)reasonsstring[]Human-readable reason codesagentIdstringThe entity identifier that was scored