Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
report
/
{address}
curl -X GET "https://api.credprotocol.com/api/v2/report/vitalik.eth" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

​
Overview

Returns a comprehensive credit report including asset balances, NFT holdings, DeFi positions, and transaction history across multiple blockchain networks.
Reports aggregate data from 10+ supported networks and are cached for 5 minutes.

​
Path Parameters

​
address
string
required
Ethereum address or ENS name (e.g., vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17)

​
Response

​
address
string
The resolved Ethereum address (checksummed)
​
score
object
Credit score summary
​
score.value
integer
Credit score between 300-1000
​
score.classification
string
Score classification
​
assets
object
Asset holdings across all networks
​
assets.total_value_usd
number
Total portfolio value in USD
​
assets.tokens
array
List of token holdings
​
assets.nfts
array
List of NFT holdings
​
defi
object
DeFi positions and activity
​
defi.protocols
array
Active DeFi protocol positions
​
defi.total_supplied
number
Total value supplied to lending protocols
​
defi.total_borrowed
number
Total value borrowed from lending protocols
​
activity
object
Transaction activity summary
​
activity.first_transaction
string
Date of first transaction
​
activity.total_transactions
integer
Total number of transactions
​
cached
boolean
Whether the response was served from cache

​
Supported Networks

Reports aggregate data from the following networks:
NetworkChain ID
Ethereum1
Polygon137
Arbitrum42161
Optimism10
Base8453
Avalanche43114
BNB Chain56
Fantom250
zkSync324
Linea59144
curl -X GET "https://api.credprotocol.com/api/v2/report/vitalik.eth" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

​
Performance

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