> ## Documentation Index
> Fetch the complete documentation index at: https://docs.credprotocol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Summary Credit Report

> Get a lightweight summary credit report without per-chain details

## 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.

<Info>
  This endpoint returns aggregated statistics only, making it significantly faster than the full report while still providing essential financial health indicators.
</Info>

## Path Parameters

<ParamField path="address" type="string" required>
  Ethereum address or ENS name (e.g., `vitalik.eth` or `0x742d35Cc6634C0532925a3b844Bc454e4438f44e`)
</ParamField>

## Response

<ResponseField name="report.address" type="string">
  The resolved Ethereum address (checksummed)
</ResponseField>

<ResponseField name="report.timestamp" type="string">
  ISO 8601 timestamp when the report was generated
</ResponseField>

<ResponseField name="report.first_transaction" type="object">
  First transaction details (timestamp, block\_number, chain\_id)
</ResponseField>

<ResponseField name="report.last_transaction" type="object">
  Most recent transaction details
</ResponseField>

<ResponseField name="report.summary" type="object">
  Aggregated credit metrics
</ResponseField>

<ResponseField name="report.summary.total_asset_usd" type="number">
  Total portfolio value in USD
</ResponseField>

<ResponseField name="report.summary.total_collateral_usd" type="number">
  Total collateral deposited in lending protocols
</ResponseField>

<ResponseField name="report.summary.total_debt_usd" type="number">
  Total debt across all DeFi protocols
</ResponseField>

<ResponseField name="report.summary.count_transactions" type="integer">
  Total transaction count across all chains
</ResponseField>

<ResponseField name="report.summary.count_transfers" type="integer">
  Total token transfer count
</ResponseField>

<ResponseField name="report.summary.count_balances" type="integer">
  Number of unique token holdings
</ResponseField>

<ResponseField name="report.summary.count_collateral_deposits" type="integer">
  Number of collateral positions
</ResponseField>

<ResponseField name="report.summary.count_active_loans" type="integer">
  Number of active loan positions
</ResponseField>

<ResponseField name="report.summary.count_liquidations" type="integer">
  Historical liquidation count
</ResponseField>

<ResponseField name="report.summary.count_defaults" type="integer">
  Historical default count
</ResponseField>

<ResponseField name="report.summary.count_repayments" type="integer">
  Successful loan repayment count
</ResponseField>

<ResponseField name="report.summary.count_identity_attestations" type="integer">
  Number of identity attestations
</ResponseField>

## 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

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/summary" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  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}`);
  ```

  ```python Python theme={null}
  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']}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
      }
    }
  }
  ```
</ResponseExample>

## Performance

* **Response Time**: 1-3 seconds (significantly faster than full report)
* **Caching**: Results cached for 5 minutes per address