Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
report
/
address
/
{address}
/
chain
/
{chain_id}
/
total
/
usd
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1/total/usd" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

NetworkChain ID
Ethereum1
Optimism10
BNB Chain56
Polygon137
Base8453
Celo42220
Arbitrum42161
Avalanche43114
Scroll534352
Linea59144

​
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 TypeIncluded
Native tokensYes
ERC-20 tokensYes
StablecoinsYes
LP tokensYes
Wrapped tokensYes
Collateral depositsYes
NFTsNo
Debt positionsNo

​
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 -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1/total/usd" \
  -H "Authorization: Bearer YOUR_API_KEY"

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