curl -X GET "https://api.credprotocol.com/api/v2/report/?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/report/?address=${addresses.join(',')}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Combined assets: $${data.report.summary.total_asset_usd}`);
import requests
addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']
response = requests.get(
'https://api.credprotocol.com/api/v2/report/',
params={'address': ','.join(addresses)},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Combined assets: ${data['report']['summary']['total_asset_usd']}")
{
"report": {
"address": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
],
"timestamp": "2024-01-15T10:30:00Z",
"first_transaction": {
"timestamp": 1438918251,
"block_number": 46147,
"chain_id": 1
},
"last_transaction": {
"timestamp": 1710255000,
"block_number": 19123456,
"chain_id": 1
},
"summary": {
"total_asset_usd": 250000.00,
"total_collateral_usd": 100000.00,
"total_debt_usd": 30000.00,
"count_transactions": 4820,
"count_transfers": 2460,
"count_balances": 48,
"count_identity_attestations": 6,
"list_identity_attestations": [
"ENS Name",
"Gitcoin Passport",
"POAP - ETHDenver 2024"
]
}
}
}
{
"error": "No valid addresses provided",
"status_code": 400
}
Report
Aggregated Credit Report
Get an aggregated credit report for multiple Ethereum addresses
GET
/
api
/
v2
/
report
/
curl -X GET "https://api.credprotocol.com/api/v2/report/?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/report/?address=${addresses.join(',')}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Combined assets: $${data.report.summary.total_asset_usd}`);
import requests
addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']
response = requests.get(
'https://api.credprotocol.com/api/v2/report/',
params={'address': ','.join(addresses)},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Combined assets: ${data['report']['summary']['total_asset_usd']}")
{
"report": {
"address": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
],
"timestamp": "2024-01-15T10:30:00Z",
"first_transaction": {
"timestamp": 1438918251,
"block_number": 46147,
"chain_id": 1
},
"last_transaction": {
"timestamp": 1710255000,
"block_number": 19123456,
"chain_id": 1
},
"summary": {
"total_asset_usd": 250000.00,
"total_collateral_usd": 100000.00,
"total_debt_usd": 30000.00,
"count_transactions": 4820,
"count_transfers": 2460,
"count_balances": 48,
"count_identity_attestations": 6,
"list_identity_attestations": [
"ENS Name",
"Gitcoin Passport",
"POAP - ETHDenver 2024"
]
}
}
}
{
"error": "No valid addresses provided",
"status_code": 400
}
Overview
Generates a single aggregated credit report combining metrics from multiple Ethereum addresses. All numeric values are summed, attestations are merged, and transaction timestamps span the earliest to most recent across all wallets.This endpoint is ideal for assessing the combined creditworthiness of multi-signature wallets, joint accounts, or organizational treasuries.
Query Parameters
string
required
Comma-separated list of Ethereum addresses or ENS names (e.g.,
address=0x123...,0x456...,vitalik.eth)Response
array
Array of all successfully analyzed addresses
string
ISO 8601 timestamp when the report was generated
object
Earliest transaction across all addresses
object
Most recent transaction across all addresses
object
Aggregated summary metrics (summed across all addresses)
number
Combined total assets in USD
number
Combined total collateral in USD
number
Combined total debt in USD
integer
Total transaction count across all addresses
integer
Count of unique attestations across all addresses
array
Merged list of unique identity attestations
Aggregation Method
| Metric Type | Aggregation |
|---|---|
| USD Values | Summed |
| Counts | Summed |
| Attestations | Merged (deduplicated) |
| First Transaction | Earliest timestamp |
| Last Transaction | Latest timestamp |
Use Cases
- Multi-signature Wallets: Complete financial picture of all signers
- Organization Assessment: Combined view of treasury wallets
- Joint Account Analysis: Aggregate credit for shared holdings
- Family Portfolios: Combined net worth and credit metrics
curl -X GET "https://api.credprotocol.com/api/v2/report/?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/report/?address=${addresses.join(',')}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(`Combined assets: $${data.report.summary.total_asset_usd}`);
import requests
addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']
response = requests.get(
'https://api.credprotocol.com/api/v2/report/',
params={'address': ','.join(addresses)},
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Combined assets: ${data['report']['summary']['total_asset_usd']}")
{
"report": {
"address": [
"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
],
"timestamp": "2024-01-15T10:30:00Z",
"first_transaction": {
"timestamp": 1438918251,
"block_number": 46147,
"chain_id": 1
},
"last_transaction": {
"timestamp": 1710255000,
"block_number": 19123456,
"chain_id": 1
},
"summary": {
"total_asset_usd": 250000.00,
"total_collateral_usd": 100000.00,
"total_debt_usd": 30000.00,
"count_transactions": 4820,
"count_transfers": 2460,
"count_balances": 48,
"count_identity_attestations": 6,
"list_identity_attestations": [
"ENS Name",
"Gitcoin Passport",
"POAP - ETHDenver 2024"
]
}
}
}
{
"error": "No valid addresses provided",
"status_code": 400
}
Performance
- Response Time: Typically 5-15 seconds (varies with address count)
- Caching: Individual address reports are cached for 5 minutes
- Parallelization: Reports are generated in parallel for optimal performance