Aggregated Credit Score

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

const addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17'];

const response = await fetch(
  `https://api.credprotocol.com/api/v2/score/?address=${addresses.join(',')}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(`Aggregated score: ${data.score}`);

import requests

addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']

response = requests.get(
    'https://api.credprotocol.com/api/v2/score/',
    params={'address': ','.join(addresses)},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Aggregated score: {data['score']}")

{
  "address": [
    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
  ],
  "score": 806,
  "decile": 6,
  "range": "good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "error": "No valid addresses provided",
  "status_code": 400
}

GET

api

score

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

const addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17'];

const response = await fetch(
  `https://api.credprotocol.com/api/v2/score/?address=${addresses.join(',')}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(`Aggregated score: ${data.score}`);

import requests

addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']

response = requests.get(
    'https://api.credprotocol.com/api/v2/score/',
    params={'address': ','.join(addresses)},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Aggregated score: {data['score']}")

{
  "address": [
    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
  ],
  "score": 806,
  "decile": 6,
  "range": "good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "error": "No valid addresses provided",
  "status_code": 400
}

Overview

Returns a single aggregated credit score for multiple Ethereum addresses, combining individual scores into one unified value. This is useful for multi-signature wallets, joint accounts, or portfolio-wide credit assessments.

Unlike the batch endpoint which returns individual scores, this endpoint aggregates all addresses into a single combined score.

Query Parameters

string

required

Comma-separated list of Ethereum addresses or ENS names (e.g., address=0x123...,0x456...,vitalik.eth)

Response

array

Array of resolved Ethereum addresses (checksummed)

integer

Aggregated credit score between 300 and 1000 (mean of individual scores)

integer

Aggregated 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

Aggregation Method

The aggregated score is calculated as the mean of all individual address scores:

Each valid address is scored individually using the Andromeda model
Invalid addresses are skipped (logged as warnings)
The final score is the arithmetic mean of all valid scores
Decile and range are derived from the aggregated score

Use Cases

Multi-signature Wallets: Assess the combined creditworthiness of all signers
Joint Account Holders: Evaluate combined credit for shared wallets
Organization Assessment: Score a company’s treasury across multiple wallets
Portfolio Credit Rating: Get a single score representing an entire portfolio

Comparison: Aggregated vs Batch

Feature	Aggregated (`/score/`)	Batch (`/score/batch/`)
Output	Single combined score	Array of individual scores
Use Case	Portfolio-wide assessment	Per-wallet analysis
Response Size	Small	Larger (scales with addresses)

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

const addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17'];

const response = await fetch(
  `https://api.credprotocol.com/api/v2/score/?address=${addresses.join(',')}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(`Aggregated score: ${data.score}`);

import requests

addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']

response = requests.get(
    'https://api.credprotocol.com/api/v2/score/',
    params={'address': ','.join(addresses)},
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Aggregated score: {data['score']}")

{
  "address": [
    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
  ],
  "score": 806,
  "decile": 6,
  "range": "good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "error": "No valid addresses provided",
  "status_code": 400
}

Performance

Response Time: Typically 3-5 seconds (addresses scored in parallel)
Caching: Individual address scores are cached for 5 minutes

Get Credit Score Batch Credit Scores

API Reference

Score

Report

Identity

Agents

Sandbox

Overview

Query Parameters

Response

Aggregation Method

Use Cases

Comparison: Aggregated vs Batch

Performance

​Overview

​Query Parameters

​Response

​Aggregation Method

​Use Cases

​Comparison: Aggregated vs Batch

​Performance

Overview

Query Parameters

Response

Aggregation Method

Use Cases

Comparison: Aggregated vs Batch

Performance