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
string
required
Ethereum address or ENS name (e.g.,
vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)Response
string
The resolved Ethereum address (checksummed)
string
ISO 8601 timestamp when the report was generated
object
First transaction details (timestamp, block_number, chain_id)
object
Most recent transaction details
object
Aggregated credit metrics
number
Total portfolio value in USD
number
Total collateral deposited in lending protocols
number
Total debt across all DeFi protocols
integer
Total transaction count across all chains
integer
Total token transfer count
integer
Number of unique token holdings
integer
Number of collateral positions
integer
Number of active loan positions
integer
Historical liquidation count
integer
Historical default count
integer
Successful loan repayment count
integer
Number of identity attestations
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