> ## 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.

# Total Portfolio Value

> Get the aggregated total USD portfolio value across all chains

## 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.

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

## Path Parameters

<ParamField path="address" type="string" required>
  Ethereum address or ENS name (e.g., `vitalik.eth` or `0x742d35Cc6634C0532925a3b844Bc454e4438f44e`)
</ParamField>

## Response

<ResponseField name="address" type="string">
  The resolved Ethereum address (checksummed)
</ResponseField>

<ResponseField name="total_asset_usd" type="number">
  Total portfolio value in USD across all chains
</ResponseField>

<ResponseField name="timestamp" type="string">
  ISO 8601 timestamp when the value was calculated
</ResponseField>

## 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 |

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/total/usd/aggregate" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

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

  const data = await response.json();
  console.log(`Total Portfolio Value: $${data.total_asset_usd.toLocaleString()}`);
  ```

  ```python Python theme={null}
  import requests

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

  data = response.json()
  print(f"Total Portfolio Value: ${data['total_asset_usd']:,.2f}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "total_asset_usd": 125000.50,
    "timestamp": "2024-01-15T10:30:00Z"
  }
  ```
</ResponseExample>

## Performance

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