Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
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"

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

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

​
Response

​
address
string
The resolved Ethereum address (checksummed)
​
timestamp
string
ISO 8601 timestamp when values were calculated
​
total_asset_usd
number
Combined total portfolio value across all chains
​
chains
array
Per-chain breakdown of asset values
​
chains[].chain_id
integer
Blockchain network ID
​
chains[].chain_name
string
Human-readable chain name
​
chains[].total_asset_usd
number
Total asset value on this chain in USD

​
Included Assets

Asset TypeIncluded
Native tokens (ETH, MATIC, etc.)Yes
ERC-20 tokensYes
Stablecoins (USDC, USDT, DAI)Yes
LP tokens (Uniswap, Curve)Yes
Wrapped tokens (WETH, WBTC)Yes
Collateral depositsYes
NFTsNo
Unclaimed rewardsNo
Pending transactionsNo
Debt positionsNo (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"

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