Mock Chain Report

Get a mock single-chain credit report for testing

GET /api/v2/sandbox/report/address/{address}/chain/{chain_id}

cURL

curl -X GET "https://api.credprotocol.com/api/v2/sandbox/report/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17/chain/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "report": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
    "timestamp": "2024-01-15T10:30:00Z",
    "summary": {
      "total_asset_usd": 85000.00,
      "count_transactions": 1800,
      "count_transfers": 900,
      "count_balances": 15
    },
    "chains": [
      {
        "chain": {
          "id": 1,
          "name": "Ethereum Mainnet",
          "has_past_activity": true,
          "current_balance_usd": 85000.00,
          "transaction_count": 1800,
          "balances": [
            {
              "symbol": "ETH",
              "name": "Ethereum",
              "usd_value": 50000.00
            },
            {
              "symbol": "USDC",
              "name": "USD Coin",
              "usd_value": 35000.00
            }
          ]
        }
      }
    ]
  }
}

Overview

Returns a mock credit report for a specific blockchain network. Use this to test chain-specific integrations.

SANDBOX: This endpoint returns mock data for testing only. Do not use for production decisions.

Path Parameters

address · string · required

Any Ethereum address (e.g., 0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17)

chain_id · integer · required

The chain ID (e.g., 1 for Ethereum, 8453 for Base)

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

report.chains · array

Array containing single chain mock data with balances

report.summary · object

Mock summary metrics for this chain only

cURL

curl -X GET "https://api.credprotocol.com/api/v2/sandbox/report/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17/chain/1" \
  -H "Authorization: Bearer YOUR_API_KEY"

200

{
  "report": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
    "timestamp": "2024-01-15T10:30:00Z",
    "summary": {
      "total_asset_usd": 85000.00,
      "count_transactions": 1800,
      "count_transfers": 900,
      "count_balances": 15
    },
    "chains": [
      {
        "chain": {
          "id": 1,
          "name": "Ethereum Mainnet",
          "has_past_activity": true,
          "current_balance_usd": 85000.00,
          "transaction_count": 1800,
          "balances": [
            {
              "symbol": "ETH",
              "name": "Ethereum",
              "usd_value": 50000.00
            },
            {
              "symbol": "USDC",
              "name": "USD Coin",
              "usd_value": 35000.00
            }
          ]
        }
      }
    ]
  }
}

Related Endpoints

Endpoint	Description
/sandbox/report/address/{address}/chain/{chain_id}/summary	Chain summary without balances
/sandbox/report/address/{address}/chain/{chain_id}/total/usd	Chain portfolio value only

Performance

• Response Time: Instant (no blockchain queries)
• Quota: Does not count against your API quota