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

# Get Credit Report

> Get a comprehensive credit report for an Ethereum address

## Overview

Returns a comprehensive credit report including asset balances, NFT holdings, DeFi positions, and transaction history across multiple blockchain networks.

<Info>
  Reports aggregate data from 10+ supported networks and are cached for 5 minutes.
</Info>

## Path Parameters

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

## Response

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

<ResponseField name="score" type="object">
  Credit score summary
</ResponseField>

<ResponseField name="score.value" type="integer">
  Credit score between 300-1000
</ResponseField>

<ResponseField name="score.classification" type="string">
  Score classification
</ResponseField>

<ResponseField name="assets" type="object">
  Asset holdings across all networks
</ResponseField>

<ResponseField name="assets.total_value_usd" type="number">
  Total portfolio value in USD
</ResponseField>

<ResponseField name="assets.tokens" type="array">
  List of token holdings
</ResponseField>

<ResponseField name="assets.nfts" type="array">
  List of NFT holdings
</ResponseField>

<ResponseField name="defi" type="object">
  DeFi positions and activity
</ResponseField>

<ResponseField name="defi.protocols" type="array">
  Active DeFi protocol positions
</ResponseField>

<ResponseField name="defi.total_supplied" type="number">
  Total value supplied to lending protocols
</ResponseField>

<ResponseField name="defi.total_borrowed" type="number">
  Total value borrowed from lending protocols
</ResponseField>

<ResponseField name="activity" type="object">
  Transaction activity summary
</ResponseField>

<ResponseField name="activity.first_transaction" type="string">
  Date of first transaction
</ResponseField>

<ResponseField name="activity.total_transactions" type="integer">
  Total number of transactions
</ResponseField>

<ResponseField name="cached" type="boolean">
  Whether the response was served from cache
</ResponseField>

## Supported Networks

Reports aggregate data from the following networks:

| Network   | Chain ID |
| --------- | -------- |
| Ethereum  | 1        |
| Polygon   | 137      |
| Arbitrum  | 42161    |
| Optimism  | 10       |
| Base      | 8453     |
| Avalanche | 43114    |
| BNB Chain | 56       |
| Fantom    | 250      |
| zkSync    | 324      |
| Linea     | 59144    |

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

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth', {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });

  const report = await response.json();
  console.log(`Total Value: $${report.assets.total_value_usd}`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.credprotocol.com/api/v2/report/address/vitalik.eth',
      headers={'Authorization': 'Bearer YOUR_API_KEY'}
  )

  report = response.json()
  print(f"Total Value: ${report['assets']['total_value_usd']}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "score": {
      "value": 847,
      "classification": "Excellent"
    },
    "assets": {
      "total_value_usd": 125000000.50,
      "tokens": [
        {
          "symbol": "ETH",
          "name": "Ethereum",
          "balance": "50000.5",
          "value_usd": 100000000,
          "chain_id": 1
        }
      ],
      "nfts": [
        {
          "name": "CryptoPunk #1234",
          "collection": "CryptoPunks",
          "chain_id": 1
        }
      ]
    },
    "defi": {
      "protocols": [
        {
          "name": "Aave",
          "supplied": 1000000,
          "borrowed": 0,
          "chain_id": 1
        }
      ],
      "total_supplied": 1000000,
      "total_borrowed": 0
    },
    "activity": {
      "first_transaction": "2015-08-07T00:00:00Z",
      "total_transactions": 15420,
      "active_chains": [1, 137, 42161]
    },
    "cached": false,
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

## Performance

* **Response Time**: Typically 3-10 seconds depending on activity
* **Caching**: Results cached for 5 minutes per address