Portfolio Composition

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

const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(`Total Portfolio: $${data.total_asset_usd}`);
data.chains.forEach(chain => {
  console.log(`${chain.chain_name}: $${chain.total_asset_usd}`);
});

import requests

response = requests.get(
    'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Total Portfolio: ${data['total_asset_usd']}")
for chain in data['chains']:
    print(f"{chain['chain_name']}: ${chain['total_asset_usd']}")

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "timestamp": "2024-01-15T10:30:00Z",
  "total_asset_usd": 125000.50,
  "chains": [
    {
      "chain_id": 1,
      "chain_name": "Ethereum",
      "total_asset_usd": 85000.50
    },
    {
      "chain_id": 8453,
      "chain_name": "Base",
      "total_asset_usd": 25000.00
    },
    {
      "chain_id": 137,
      "chain_name": "Polygon",
      "total_asset_usd": 15000.00
    }
  ]
}

GET

api

report

address

{address}

total

usd

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

const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(`Total Portfolio: $${data.total_asset_usd}`);
data.chains.forEach(chain => {
  console.log(`${chain.chain_name}: $${chain.total_asset_usd}`);
});

import requests

response = requests.get(
    'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Total Portfolio: ${data['total_asset_usd']}")
for chain in data['chains']:
    print(f"{chain['chain_name']}: ${chain['total_asset_usd']}")

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "timestamp": "2024-01-15T10:30:00Z",
  "total_asset_usd": 125000.50,
  "chains": [
    {
      "chain_id": 1,
      "chain_name": "Ethereum",
      "total_asset_usd": 85000.50
    },
    {
      "chain_id": 8453,
      "chain_name": "Base",
      "total_asset_usd": 25000.00
    },
    {
      "chain_id": 137,
      "chain_name": "Polygon",
      "total_asset_usd": 15000.00
    }
  ]
}

Overview

Returns the portfolio composition showing the USD value of assets held by an address on each supported blockchain network. This endpoint is useful for understanding cross-chain asset distribution and portfolio diversification.

This endpoint provides a breakdown of value by chain, while the /total/usd/aggregate endpoint provides a single combined total.

Path Parameters

string

required

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

Response

string

The resolved Ethereum address (checksummed)

string

ISO 8601 timestamp when values were calculated

number

Combined total portfolio value across all chains

array

Per-chain breakdown of asset values

integer

Blockchain network ID

string

Human-readable chain name

number

Total asset value on this chain in USD

Included Assets

Asset Type	Included
Native tokens (ETH, MATIC, etc.)	Yes
ERC-20 tokens	Yes
Stablecoins (USDC, USDT, DAI)	Yes
LP tokens (Uniswap, Curve)	Yes
Wrapped tokens (WETH, WBTC)	Yes
Collateral deposits	Yes
NFTs	No
Unclaimed rewards	No
Pending transactions	No
Debt positions	No (separate field)

Pricing Sources

Primary: Chainlink on-chain oracles (real-time)
Fallback: CoinGecko API (for tokens without oracle coverage)
Update Frequency: Prices refresh every 60 seconds
Denomination: All values in USD

Use Cases

Portfolio Diversification: Visualize asset distribution across chains
Chain-Level Tracking: Monitor holdings on specific networks
Rebalancing Decisions: Identify over/under-weighted chains
Cross-Chain Analytics: Compare activity across L1s and L2s

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

const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(`Total Portfolio: $${data.total_asset_usd}`);
data.chains.forEach(chain => {
  console.log(`${chain.chain_name}: $${chain.total_asset_usd}`);
});

import requests

response = requests.get(
    'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(f"Total Portfolio: ${data['total_asset_usd']}")
for chain in data['chains']:
    print(f"{chain['chain_name']}: ${chain['total_asset_usd']}")

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "timestamp": "2024-01-15T10:30:00Z",
  "total_asset_usd": 125000.50,
  "chains": [
    {
      "chain_id": 1,
      "chain_name": "Ethereum",
      "total_asset_usd": 85000.50
    },
    {
      "chain_id": 8453,
      "chain_name": "Base",
      "total_asset_usd": 25000.00
    },
    {
      "chain_id": 137,
      "chain_name": "Polygon",
      "total_asset_usd": 15000.00
    }
  ]
}

Performance

Response Time: < 1 second
Caching: Results cached for 5 minutes per address

Chain-Specific Summary Total Portfolio Value

API Reference

Score

Report

Identity

Agents

Sandbox

Overview

Path Parameters

Response

Included Assets

Pricing Sources

Use Cases

Performance

​Overview

​Path Parameters

​Response

​Included Assets

​Pricing Sources

​Use Cases

​Performance

Overview

Path Parameters

Response

Included Assets

Pricing Sources

Use Cases

Performance