Skip to main content
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"

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

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.

​
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

FeatureSummary ReportFull Report
Response Time1-3 seconds3-10 seconds
Payload Size~1 KB~10-50 KB
Chain DetailsNoYes
Token BalancesNoYes
NFT ListingsNoYes
DeFi PositionsNoYes
Caching5 minutes5 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"

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