Skip to main content
GET
/
api
/
v2
/
report
/
address
/
{address}
/
chain
/
{chain_id}
/
summary
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1/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": 85000.00,
      "total_collateral_usd": 40000.00,
      "total_debt_usd": 10000.00,
      "count_transactions": 1800,
      "count_transfers": 900,
      "count_balances": 15
    }
  }
}

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 for a single blockchain network, without detailed asset breakdowns. This is the fastest way to get chain-specific credit data.
Combines the speed of the summary endpoint with the focus of chain-specific analysis.

​
Path Parameters

​
address
string
required
Ethereum address or ENS name (e.g., vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc454e4438f44e)
​
chain_id
integer
required
The chain ID to fetch data from (e.g., 1 for Ethereum mainnet)

​
Supported Chain IDs

NetworkChain ID
Ethereum1
Optimism10
BNB Chain56
Polygon137
Base8453
Celo42220
Arbitrum42161
Avalanche43114
Scroll534352
Linea59144

​
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 on this chain
​
report.last_transaction
object
Most recent transaction on this chain
​
report.summary
object
Summary metrics for this chain only

​
Use Cases

  • Chain Migration Analysis: Quick assessment before moving assets
  • L2 Adoption Tracking: Monitor activity on specific Layer 2s
  • Protocol-Specific Risk: Assess exposure on a single network
  • Gas Optimization: Check activity before transactions
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1/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": 85000.00,
      "total_collateral_usd": 40000.00,
      "total_debt_usd": 10000.00,
      "count_transactions": 1800,
      "count_transfers": 900,
      "count_balances": 15
    }
  }
}

​
Performance

  • Response Time: < 1 second
  • Caching: Results cached for 5 minutes per address+chain combination