curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Total Assets: $${data.report.summary.total_asset_usd}`);
console.log(`Active Loans: ${data.report.summary.count_active_loans}`);
import requests
response = requests.get(
'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Total Assets: ${data['report']['summary']['total_asset_usd']}")
print(f"Active Loans: {data['report']['summary']['count_active_loans']}")
{
"report": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"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": 125000.50,
"total_collateral_usd": 50000.00,
"total_debt_usd": 15000.00,
"count_transactions": 2456,
"count_transfers": 1234,
"count_balances": 25,
"count_collateral_deposits": 5,
"count_active_loans": 2,
"count_liquidations": 0,
"count_defaults": 0,
"count_repayments": 12,
"count_identity_attestations": 4
}
}
}
Report
Summary Credit Report
Get a lightweight summary credit report without per-chain details
GET
/
api
/
v2
/
report
/
address
/
{address}
/
summary
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Total Assets: $${data.report.summary.total_asset_usd}`);
console.log(`Active Loans: ${data.report.summary.count_active_loans}`);
import requests
response = requests.get(
'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Total Assets: ${data['report']['summary']['total_asset_usd']}")
print(f"Active Loans: {data['report']['summary']['count_active_loans']}")
{
"report": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"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": 125000.50,
"total_collateral_usd": 50000.00,
"total_debt_usd": 15000.00,
"count_transactions": 2456,
"count_transfers": 1234,
"count_balances": 25,
"count_collateral_deposits": 5,
"count_active_loans": 2,
"count_liquidations": 0,
"count_defaults": 0,
"count_repayments": 12,
"count_identity_attestations": 4
}
}
}
Overview
Returns a lightweight summary of key credit metrics across all supported blockchain networks, without the detailed per-chain breakdowns included in the full report. This endpoint is optimized for speed and is ideal for dashboards and quick assessments.This endpoint returns aggregated statistics only, making it significantly faster than the full report while still providing essential financial health indicators.
Path Parameters
Ethereum address or ENS name (e.g.,
vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)Response
Total portfolio value in USD: tokens held plus lending deposits. Debt is not included; see
total_debt_usdAlways
0. Overcollateralized lending protocols close positions by liquidation and have no default state.Number of voluntary loan repayments on Aave V2 or V3 (Ethereum) or Aave V3 (Base). Repayments made through liquidation are not counted.
Summary vs Full Report
| Feature | Summary Report | Full Report |
|---|---|---|
| Response Time | 1-3 seconds | 3-10 seconds |
| Payload Size | ~1 KB | ~10-50 KB |
| Chain Details | No | Yes |
| Token Balances | No | Yes |
| NFT Listings | No | Yes |
| DeFi Positions | No | Yes |
| Caching | 5 minutes | 5 minutes |
Use Cases
- Dashboard Summary Cards: Quick overview of wallet health
- Mobile Applications: Faster load times with smaller payloads
- High-Volume Screening: Efficiently evaluate many addresses
- Portfolio Overviews: Quick net worth and activity snapshots
- Risk Pre-screening: Fast initial creditworthiness check
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const data = await response.json();
console.log(`Total Assets: $${data.report.summary.total_asset_usd}`);
console.log(`Active Loans: ${data.report.summary.count_active_loans}`);
import requests
response = requests.get(
'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
data = response.json()
print(f"Total Assets: ${data['report']['summary']['total_asset_usd']}")
print(f"Active Loans: {data['report']['summary']['count_active_loans']}")
{
"report": {
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"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": 125000.50,
"total_collateral_usd": 50000.00,
"total_debt_usd": 15000.00,
"count_transactions": 2456,
"count_transfers": 1234,
"count_balances": 25,
"count_collateral_deposits": 5,
"count_active_loans": 2,
"count_liquidations": 0,
"count_defaults": 0,
"count_repayments": 12,
"count_identity_attestations": 4
}
}
}
Performance
- Response Time: 1-3 seconds (significantly faster than full report)
- Caching: Results cached for 5 minutes per address