Summary Credit Report

Get a lightweight summary credit report without per-chain details

GET /api/v2/report/address/{address}/summary

cURL

curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "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

address · string · required

Ethereum address or ENS name (e.g., vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)

Response

report.address · string

The resolved Ethereum address (checksummed)

report.timestamp · string

ISO 8601 timestamp when the report was generated

report.first_transaction · object

First transaction details (timestamp, block_number, chain_id)

report.last_transaction · object

Most recent transaction details

report.summary · object

Aggregated credit metrics

report.summary.total_asset_usd · number

Total portfolio value in USD

report.summary.total_collateral_usd · number

Total collateral deposited in lending protocols

report.summary.total_debt_usd · number

Total debt across all DeFi protocols

report.summary.count_transactions · integer

Total transaction count across all chains

report.summary.count_transfers · integer

Total token transfer count

report.summary.count_balances · integer

Number of unique token holdings

report.summary.count_collateral_deposits · integer

Number of collateral positions

report.summary.count_active_loans · integer

Number of active loan positions

report.summary.count_liquidations · integer

Historical liquidation count

report.summary.count_defaults · integer

Historical default count

report.summary.count_repayments · integer

Successful loan repayment count

report.summary.count_identity_attestations · 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

curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "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