Total Portfolio Value

Get the aggregated total USD portfolio value across all chains

GET /api/v2/report/address/{address}/total/usd/aggregate

cURL

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

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "total_asset_usd": 125000.50,
  "timestamp": "2024-01-15T10:30:00Z"
}

Overview

Returns the aggregated total USD value of all assets held by an address across all supported blockchain networks. This is the simplest endpoint for getting a wallet’s total value.

This endpoint returns a single total value. For a breakdown by chain, use the /total/usd endpoint instead.

Path Parameters

address · string · required

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

Response

address · string

The resolved Ethereum address (checksummed)

total_asset_usd · number

Total portfolio value in USD across all chains

timestamp · string

ISO 8601 timestamp when the value was calculated

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

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

• Quick Net Worth: Single API call for total portfolio value
• Portfolio Tracking: Monitor total holdings over time
• Lending Capacity: Assess collateral potential
• Wallet Comparison: Compare total holdings across wallets

Related Endpoints

Endpoint	Returns
/total/usd/aggregate	Single total value
/total/usd	Breakdown by chain
/chain/{chain_id}/total/usd	Single chain value

cURL

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

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "total_asset_usd": 125000.50,
  "timestamp": "2024-01-15T10:30:00Z"
}

Performance

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