Aggregated Credit Report

curl -X GET "https://api.credprotocol.com/api/v2/report/?address=vitalik.eth,0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"

const addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17'];

const response = await fetch(
  `https://api.credprotocol.com/api/v2/report/?address=${addresses.join(',')}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(`Combined assets: $${data.report.summary.total_asset_usd}`);

import requests

addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']

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

data = response.json()
print(f"Combined assets: ${data['report']['summary']['total_asset_usd']}")

{
  "report": {
    "address": [
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
    ],
    "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": 250000.00,
      "total_collateral_usd": 100000.00,
      "total_debt_usd": 30000.00,
      "count_transactions": 4820,
      "count_transfers": 2460,
      "count_balances": 48,
      "count_identity_attestations": 6,
      "list_identity_attestations": [
        "ENS Name",
        "Gitcoin Passport",
        "POAP - ETHDenver 2024"
      ]
    }
  }
}

{
  "error": "No valid addresses provided",
  "status_code": 400
}

GET

api

report

curl -X GET "https://api.credprotocol.com/api/v2/report/?address=vitalik.eth,0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"

const addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17'];

const response = await fetch(
  `https://api.credprotocol.com/api/v2/report/?address=${addresses.join(',')}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(`Combined assets: $${data.report.summary.total_asset_usd}`);

import requests

addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']

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

data = response.json()
print(f"Combined assets: ${data['report']['summary']['total_asset_usd']}")

{
  "report": {
    "address": [
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
    ],
    "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": 250000.00,
      "total_collateral_usd": 100000.00,
      "total_debt_usd": 30000.00,
      "count_transactions": 4820,
      "count_transfers": 2460,
      "count_balances": 48,
      "count_identity_attestations": 6,
      "list_identity_attestations": [
        "ENS Name",
        "Gitcoin Passport",
        "POAP - ETHDenver 2024"
      ]
    }
  }
}

{
  "error": "No valid addresses provided",
  "status_code": 400
}

Overview

Generates a single aggregated credit report combining metrics from multiple Ethereum addresses. All numeric values are summed, attestations are merged, and transaction timestamps span the earliest to most recent across all wallets.

This endpoint is ideal for assessing the combined creditworthiness of multi-signature wallets, joint accounts, or organizational treasuries.

Query Parameters

string

required

Comma-separated list of Ethereum addresses or ENS names (e.g., address=0x123...,0x456...,vitalik.eth)

Response

array

Array of all successfully analyzed addresses

string

ISO 8601 timestamp when the report was generated

object

Earliest transaction across all addresses

object

Most recent transaction across all addresses

object

Aggregated summary metrics (summed across all addresses)

number

Combined total assets in USD

number

Combined total collateral in USD

number

Combined total debt in USD

integer

Total transaction count across all addresses

integer

Count of unique attestations across all addresses

array

Merged list of unique identity attestations

Aggregation Method

Metric Type	Aggregation
USD Values	Summed
Counts	Summed
Attestations	Merged (deduplicated)
First Transaction	Earliest timestamp
Last Transaction	Latest timestamp

Use Cases

Multi-signature Wallets: Complete financial picture of all signers
Organization Assessment: Combined view of treasury wallets
Joint Account Analysis: Aggregate credit for shared holdings
Family Portfolios: Combined net worth and credit metrics

curl -X GET "https://api.credprotocol.com/api/v2/report/?address=vitalik.eth,0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"

const addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17'];

const response = await fetch(
  `https://api.credprotocol.com/api/v2/report/?address=${addresses.join(',')}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const data = await response.json();
console.log(`Combined assets: $${data.report.summary.total_asset_usd}`);

import requests

addresses = ['vitalik.eth', '0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17']

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

data = response.json()
print(f"Combined assets: ${data['report']['summary']['total_asset_usd']}")

{
  "report": {
    "address": [
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17"
    ],
    "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": 250000.00,
      "total_collateral_usd": 100000.00,
      "total_debt_usd": 30000.00,
      "count_transactions": 4820,
      "count_transfers": 2460,
      "count_balances": 48,
      "count_identity_attestations": 6,
      "list_identity_attestations": [
        "ENS Name",
        "Gitcoin Passport",
        "POAP - ETHDenver 2024"
      ]
    }
  }
}

{
  "error": "No valid addresses provided",
  "status_code": 400
}

Performance

Response Time: Typically 5-15 seconds (varies with address count)
Caching: Individual address reports are cached for 5 minutes
Parallelization: Reports are generated in parallel for optimal performance

Enhanced Credit Report Summary Credit Report

API Reference

Score

Report

Identity

Agents

Sandbox

Aggregated Credit Report

Overview

Query Parameters

Response

Aggregation Method

Use Cases

Performance

​Overview

​Query Parameters

​Response

​Aggregation Method

​Use Cases

​Performance

Overview

Query Parameters

Response

Aggregation Method

Use Cases

Performance