Mock Credit Score

Get a mock credit score for testing purposes

GET /api/v2/sandbox/score/address/{address}

cURL

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

200

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
  "score": 726,
  "decile": 8,
  "range": "good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

Overview

Returns a deterministic mock credit score for testing your integration. The score is calculated based on the address, so the same address always returns the same mock score.

⚠️ 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/score/address/{address} endpoint.

address · string

The input Ethereum address

score · integer

Mock credit score between 300 and 1000

decile · integer

Score decile from 1 to 10

range · string

Score range: low, fair, good, very_good, or excellent

model_version · string

Always returns andromeda_1.0

timestamp · string

ISO 8601 timestamp when the mock score was generated

cURL

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

200

{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
  "score": 726,
  "decile": 8,
  "range": "good",
  "model_version": "andromeda_1.0",
  "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