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