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

{
  "scores": [
    {
      "address": "0x1111111111111111111111111111111111111111",
      "score": 726,
      "decile": 8,
      "range": "good",
      "model_version": "andromeda_1.0",
      "timestamp": "2024-01-15T10:30:00Z"
    },
    {
      "address": "0x2222222222222222222222222222222222222222",
      "score": 845,
      "decile": 9,
      "range": "very_good",
      "model_version": "andromeda_1.0",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  ],
  "count": 2
}

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 mock individual credit scores for multiple addresses without aggregation. Use this to test batch scoring scenarios where you need per-wallet scores.
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

​
scores
array
Array of individual mock score objects
​
scores[].address
string
The Ethereum address
​
scores[].score
integer
Mock credit score between 300 and 1000
​
scores[].decile
integer
Score decile from 1 to 10
​
scores[].range
string
Score range: low, fair, good, very_good, or excellent
​
count
integer
Number of scores returned

​
Comparison: Batch vs Aggregated

EndpointReturnsUse Case
/sandbox/score/batch/Individual scores per addressPer-wallet display
/sandbox/score/Single aggregated scoreCombined assessment
curl -X GET "https://api.credprotocol.com/api/v2/sandbox/score/batch/?address=0x1111111111111111111111111111111111111111,0x2222222222222222222222222222222222222222" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "scores": [
    {
      "address": "0x1111111111111111111111111111111111111111",
      "score": 726,
      "decile": 8,
      "range": "good",
      "model_version": "andromeda_1.0",
      "timestamp": "2024-01-15T10:30:00Z"
    },
    {
      "address": "0x2222222222222222222222222222222222222222",
      "score": 845,
      "decile": 9,
      "range": "very_good",
      "model_version": "andromeda_1.0",
      "timestamp": "2024-01-15T10:30:00Z"
    }
  ],
  "count": 2
}

​
Performance

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