Chain Portfolio Value

Get the total USD portfolio value for a specific blockchain

GET /api/v2/report/address/{address}/chain/{chain_id}/total/usd

cURL

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

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "timestamp": "2024-01-15T10:30:00Z",
  "chains": [
    {
      "chain_id": 1,
      "chain_name": "Ethereum",
      "total_asset_usd": 85000.50
    }
  ]
}

Overview

Returns the total USD value of assets held by an address on a specific blockchain network. This is the fastest way to check holdings on a single chain.

Same pricing and inclusion rules as the all-chains portfolio endpoints, but scoped to a single network.

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

Network	Chain ID
Ethereum	1
Optimism	10
BNB Chain	56
Polygon	137
Base	8453
Celo	42220
Arbitrum	42161
Avalanche	43114
Scroll	534352
Linea	59144

Response

address · string

The resolved Ethereum address (checksummed)

timestamp · string

ISO 8601 timestamp when the value was calculated

chains · array

Array containing the single chain’s data

chains[].chain_id · integer

The requested chain 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 Type	Included
Native tokens	Yes
ERC-20 tokens	Yes
Stablecoins	Yes
LP tokens	Yes
Wrapped tokens	Yes
Collateral deposits	Yes
NFTs	No
Debt positions	No

Use Cases

• Chain-Specific Monitoring: Track holdings on a specific L2
• Pre-Transaction Check: Verify balance before bridging
• Gas Planning: Check native token balance for gas
• Protocol Analysis: Monitor holdings on specific chains

cURL

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

200

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "timestamp": "2024-01-15T10:30:00Z",
  "chains": [
    {
      "chain_id": 1,
      "chain_name": "Ethereum",
      "total_asset_usd": 85000.50
    }
  ]
}

Performance

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