Skip to main content
POST
https://api.credprotocol.com
/
api
/
v2
/
sandbox
/
score
/
address
/
{address}
curl -X POST "https://api.credprotocol.com/api/v2/sandbox/score/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_asset_usd": 50000}'

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

​
Overview

Returns a mock enhanced credit score that simulates the boost calculation from off-chain assets. Use this to test your integration with the enhanced score endpoint.
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)

​
Request Body

​
total_asset_usd
number
Simulated off-chain asset value in USD. Higher values result in a larger mock boost.

​
Response

The response format is identical to the production POST /api/v2/score/address/{address} endpoint.
​
address
string
The input Ethereum address
​
score
integer
Mock enhanced 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

​
Mock Boost Calculation

The sandbox simulates the boost calculation:
  • Boost factor = min(total_asset_usd / 100000, 1.0)
  • Maximum boost at $100,000 in off-chain assets
  • Boost increases the base mock score proportionally
curl -X POST "https://api.credprotocol.com/api/v2/sandbox/score/address/0x742d35Cc6634C0532925a3b844Bc9e7595f0Ab17" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_asset_usd": 50000}'

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

​
Performance

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