Skip to main content

Reputation API

Get All Scores​

GET /api/v1/reputation/{address}

Returns scores for all 9 categories.

Response​

{
  "address": "0x1234...",
  "did": "did:ethr:0x1234...",
  "scores": [
    {
      "category": "OVERALL",
      "score": 742,
      "confidence": 0.91,
      "tier": "High",
      "calculatedAt": "2026-02-27T12:00:00Z",
      "modelVersion": "1.0.0"
    }
  ]
}

Get Single Category Score​

GET /api/v1/reputation/{address}/{category}

Categories: OVERALL, DEFI_LENDING, DEFI_TRADING, GOVERNANCE, NFT, IDENTITY, SOCIAL, DEVELOPER, COMPLIANCE

Cached for 60 seconds per address/category combination.

Batch Query​

POST /api/v1/reputation/batch
{
  "addresses": ["0xABCD...", "0x1234..."],
  "category": "OVERALL"
}

Maximum 100 addresses per request.

Generate ZK Proof​

POST /api/v1/reputation/prove
{
  "subject": "0x1234...",
  "proofType": "ScoreAboveThreshold",
  "category": "DEFI_LENDING",
  "threshold": 700
}

Verify ZK Proof​

POST /api/v1/reputation/verify
{"proof": "0x1a2b3c..."}

Returns {"valid": true} or {"valid": false}.