curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const report = await response.json();
console.log(`Ethereum holdings: $${report.assets.total_value_usd}`);
import requests
response = requests.get(
'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
report = response.json()
print(f"Ethereum holdings: ${report['assets']['total_value_usd']}")
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"chain_id": 1,
"chain_name": "Ethereum",
"assets": {
"total_value_usd": 100000000,
"tokens": [
{
"symbol": "ETH",
"name": "Ethereum",
"balance": "50000.5",
"value_usd": 100000000
}
],
"nfts": [
{
"name": "CryptoPunk #1234",
"collection": "CryptoPunks"
}
]
},
"defi": {
"protocols": [
{
"name": "Aave",
"supplied": 1000000,
"borrowed": 0
}
],
"total_supplied": 1000000,
"total_borrowed": 0
},
"activity": {
"first_transaction": "2015-08-07T00:00:00Z",
"total_transactions": 12000
},
"cached": false,
"timestamp": "2024-01-15T10:30:00Z"
}
{
"detail": "Invalid chain ID. See documentation for supported chains."
}
Report
Chain-Specific Report
Get a credit report for a specific blockchain network
GET
/
api
/
v2
/
report
/
address
/
{address}
/
chain
/
{chain_id}
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const report = await response.json();
console.log(`Ethereum holdings: $${report.assets.total_value_usd}`);
import requests
response = requests.get(
'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
report = response.json()
print(f"Ethereum holdings: ${report['assets']['total_value_usd']}")
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"chain_id": 1,
"chain_name": "Ethereum",
"assets": {
"total_value_usd": 100000000,
"tokens": [
{
"symbol": "ETH",
"name": "Ethereum",
"balance": "50000.5",
"value_usd": 100000000
}
],
"nfts": [
{
"name": "CryptoPunk #1234",
"collection": "CryptoPunks"
}
]
},
"defi": {
"protocols": [
{
"name": "Aave",
"supplied": 1000000,
"borrowed": 0
}
],
"total_supplied": 1000000,
"total_borrowed": 0
},
"activity": {
"first_transaction": "2015-08-07T00:00:00Z",
"total_transactions": 12000
},
"cached": false,
"timestamp": "2024-01-15T10:30:00Z"
}
{
"detail": "Invalid chain ID. See documentation for supported chains."
}
Overview
Returns a credit report for a single blockchain network, useful when you only need data from a specific chain.Use this endpoint for faster responses when you don’t need cross-chain data.
Path Parameters
string
required
Ethereum address or ENS name (e.g.,
vitalik.eth or 0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17)integer
required
The chain ID to fetch data from (e.g.,
1 for Ethereum mainnet)Supported Chain IDs
| Network | Chain ID |
|---|---|
| Ethereum | 1 |
| Polygon | 137 |
| Arbitrum | 42161 |
| Optimism | 10 |
| Base | 8453 |
| Avalanche | 43114 |
| BNB Chain | 56 |
| Fantom | 250 |
| zkSync | 324 |
| Linea | 59144 |
Response
string
The resolved Ethereum address (checksummed)
integer
The chain ID for this report
string
Human-readable chain name
object
Asset holdings on this chain
object
DeFi positions on this chain
object
Transaction activity on this chain
curl -X GET "https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch('https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
});
const report = await response.json();
console.log(`Ethereum holdings: $${report.assets.total_value_usd}`);
import requests
response = requests.get(
'https://api.credprotocol.com/api/v2/report/address/vitalik.eth/chain/1',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
report = response.json()
print(f"Ethereum holdings: ${report['assets']['total_value_usd']}")
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"chain_id": 1,
"chain_name": "Ethereum",
"assets": {
"total_value_usd": 100000000,
"tokens": [
{
"symbol": "ETH",
"name": "Ethereum",
"balance": "50000.5",
"value_usd": 100000000
}
],
"nfts": [
{
"name": "CryptoPunk #1234",
"collection": "CryptoPunks"
}
]
},
"defi": {
"protocols": [
{
"name": "Aave",
"supplied": 1000000,
"borrowed": 0
}
],
"total_supplied": 1000000,
"total_borrowed": 0
},
"activity": {
"first_transaction": "2015-08-07T00:00:00Z",
"total_transactions": 12000
},
"cached": false,
"timestamp": "2024-01-15T10:30:00Z"
}
{
"detail": "Invalid chain ID. See documentation for supported chains."
}
Performance
- Response Time: Typically 1-3 seconds (faster than full report)
- Caching: Results cached for 5 minutes per address/chain combination