Chain-Specific Report

Get a credit report for a specific blockchain network

GET /api/v2/report/address/{address}/chain/{chain_id}

cURL

curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain_id": 1,
  "chain_name": "Ethereum",
  "assets": {
    "total_value_usd": 100000000,
    "tokens": [
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "balance": "50000.5",
        "value_usd": 100000000
      }
    ],
    "nfts": [
      {
        "name": "CryptoPunk #1234",
        "collection": "CryptoPunks"
      }
    ]
  },
  "defi": {
    "protocols": [
      {
        "name": "Aave",
        "supplied": 1000000,
        "borrowed": 0
      }
    ],
    "total_supplied": 1000000,
    "total_borrowed": 0
  },
  "activity": {
    "first_transaction": "2015-08-07T00:00:00Z",
    "total_transactions": 12000
  },
  "cached": false,
  "timestamp": "2024-01-15T10:30:00Z"
}

Overview

Returns a credit report for a single blockchain network, useful when you only need data from a specific chain.

Use this endpoint for faster responses when you don’t need cross-chain data.

Path Parameters

address · string · required

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

chain_id · integer · required

The chain ID to fetch data from (e.g., 1 for Ethereum mainnet)

Supported Chain IDs

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

Response

address · string

The resolved Ethereum address (checksummed)

chain_id · integer

The chain ID for this report

chain_name · string

Human-readable chain name

assets · object

Asset holdings on this chain

defi · object

DeFi positions on this chain

activity · object

Transaction activity on this chain

cURL

curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain_id": 1,
  "chain_name": "Ethereum",
  "assets": {
    "total_value_usd": 100000000,
    "tokens": [
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "balance": "50000.5",
        "value_usd": 100000000
      }
    ],
    "nfts": [
      {
        "name": "CryptoPunk #1234",
        "collection": "CryptoPunks"
      }
    ]
  },
  "defi": {
    "protocols": [
      {
        "name": "Aave",
        "supplied": 1000000,
        "borrowed": 0
      }
    ],
    "total_supplied": 1000000,
    "total_borrowed": 0
  },
  "activity": {
    "first_transaction": "2015-08-07T00:00:00Z",
    "total_transactions": 12000
  },
  "cached": false,
  "timestamp": "2024-01-15T10:30:00Z"
}

Performance

• Response Time: Typically 1-3 seconds (faster than full report)
• Caching: Results cached for 5 minutes per address/chain combination