Skip to main content
GET
/
api
/
v2
/
sandbox
/
score
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/score/?address=0x1111111111111111111111111111111111111111,0x2222222222222222222222222222222222222222" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": [
    "0x1111111111111111111111111111111111111111",
    "0x2222222222222222222222222222222222222222"
  ],
  "score": 745,
  "decile": 8,
  "range": "good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.credprotocol.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Returns a mock aggregated credit score combining multiple addresses into a single score. Use this to test multi-wallet scoring scenarios like multi-signature wallets or joint accounts.
SANDBOX: This endpoint returns mock data for testing only. Do not use for production decisions.

​
Query Parameters

​
address
string
required
Comma-separated list of Ethereum addresses (e.g., address=0x123...,0x456...,0x789...)

​
Response

​
address
array
Array of validated Ethereum addresses
​
score
integer
Mock aggregated credit score (mean of individual mock scores)
​
decile
integer
Aggregated 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

​
Mock Aggregation

The sandbox calculates the aggregated score as:
  1. Generate deterministic mock score for each address
  2. Calculate the mean of all individual scores
  3. Derive decile and range from the aggregated score
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/score/?address=0x1111111111111111111111111111111111111111,0x2222222222222222222222222222222222222222" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "address": [
    "0x1111111111111111111111111111111111111111",
    "0x2222222222222222222222222222222222222222"
  ],
  "score": 745,
  "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