Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
sandbox
/
report
/
{address}
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/report/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
  "score": {
    "value": 723,
    "classification": "Good"
  },
  "assets": {
    "total_value_usd": 50000.00,
    "tokens": [
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "balance": "10.5",
        "value_usd": 35000,
        "chain_id": 1
      },
      {
        "symbol": "USDC",
        "name": "USD Coin",
        "balance": "15000",
        "value_usd": 15000,
        "chain_id": 1
      }
    ],
    "nfts": [
      {
        "name": "Mock NFT #1234",
        "collection": "Mock Collection",
        "chain_id": 1
      }
    ]
  },
  "defi": {
    "protocols": [
      {
        "name": "Mock Protocol",
        "supplied": 10000,
        "borrowed": 0,
        "chain_id": 1
      }
    ],
    "total_supplied": 10000,
    "total_borrowed": 0
  },
  "activity": {
    "first_transaction": "2021-01-01T00:00:00Z",
    "total_transactions": 500,
    "active_chains": [1, 137]
  },
  "sandbox": true,
  "cached": false,
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Overview

Returns a deterministic mock credit report for testing your integration. The report contains realistic mock data structure identical to production responses.
⚠️ 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)

​
Response

The response format is identical to the production /api/v2/report/{address} endpoint.
​
address
string
The input Ethereum address
​
score
object
Mock credit score summary
​
assets
object
Mock asset holdings
​
defi
object
Mock DeFi positions
​
activity
object
Mock transaction activity
​
sandbox
boolean
Always true for sandbox responses
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/report/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
  "score": {
    "value": 723,
    "classification": "Good"
  },
  "assets": {
    "total_value_usd": 50000.00,
    "tokens": [
      {
        "symbol": "ETH",
        "name": "Ethereum",
        "balance": "10.5",
        "value_usd": 35000,
        "chain_id": 1
      },
      {
        "symbol": "USDC",
        "name": "USD Coin",
        "balance": "15000",
        "value_usd": 15000,
        "chain_id": 1
      }
    ],
    "nfts": [
      {
        "name": "Mock NFT #1234",
        "collection": "Mock Collection",
        "chain_id": 1
      }
    ]
  },
  "defi": {
    "protocols": [
      {
        "name": "Mock Protocol",
        "supplied": 10000,
        "borrowed": 0,
        "chain_id": 1
      }
    ],
    "total_supplied": 10000,
    "total_borrowed": 0
  },
  "activity": {
    "first_transaction": "2021-01-01T00:00:00Z",
    "total_transactions": 500,
    "active_chains": [1, 137]
  },
  "sandbox": true,
  "cached": false,
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Performance

  • Response Time: Instant (no blockchain queries)
  • Caching: Mock data is deterministic, no caching needed
  • Rate Limits: Standard rate limits apply
  • Quota: Does not count against your API quota