Skip to main content
GET
https://api.credprotocol.com
/
api
/
v2
/
sandbox
/
score
/
{address}
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/score/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
  "score": 723,
  "classification": "Good",
  "model": "sandbox",
  "sandbox": true,
  "cached": false,
  "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} endpoint.
address
string
The input Ethereum address
score
integer
Mock credit score between 300 and 1000
classification
string
Score classification: Low, Fair, Good, Very Good, or Excellent
model
string
Always returns sandbox
sandbox
boolean
Always true for sandbox responses
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/score/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17",
  "score": 723,
  "classification": "Good",
  "model": "sandbox",
  "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