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

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

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

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

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

​
Response

​
report.address
array
Array of all successfully analyzed addresses
​
report.timestamp
string
ISO 8601 timestamp when the report was generated
​
report.first_transaction
object
Earliest transaction across all addresses
​
report.last_transaction
object
Most recent transaction across all addresses
​
report.summary
object
Aggregated summary metrics (summed across all addresses)
​
report.summary.total_asset_usd
number
Combined total assets in USD
​
report.summary.total_collateral_usd
number
Combined total collateral in USD
​
report.summary.total_debt_usd
number
Combined total debt in USD
​
report.summary.count_transactions
integer
Total transaction count across all addresses
​
report.summary.count_identity_attestations
integer
Count of unique attestations across all addresses
​
report.summary.list_identity_attestations
array
Merged list of unique identity attestations

​
Aggregation Method

Metric TypeAggregation
USD ValuesSummed
CountsSummed
AttestationsMerged (deduplicated)
First TransactionEarliest timestamp
Last TransactionLatest 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"

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

​
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