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