REST API

JSON API for off-chain consumption. Base URL:

https://oracle.blackhart.io/api/v1

Endpoints

GET/api/v1/scores

List all scored protocols with current BRI and Forge Scale.

GET/api/v1/scores/:slug

Full score breakdown including all 12 dimensions and evidence hash.

POST/api/v1/scores/batchComing Soon

Batch fetch up to 50 protocols. Body: { "slugs": [...] }

GET/api/v1/scores/:slug/historyComing SoonDeveloper

Score history over time. 7-day history with Developer tier ($49/mo).

GET/api/v1/scores/:slug/dimensionsComing SoonDeveloper

Detailed dimension breakdown with individual scores.

WS/api/v1/ws/scoresComing SoonDeveloper

Real-time WebSocket feed of score changes.

Response Format

Single protocol response from GET /api/v1/scores/:slug:

Response

{
  "slug": "uniswap-v4",
  "bri": 913,
  "forgeScale": "MITHRIL",
  "forgeScaleNum": 6,
  "confidence": 67,
  "delta": -3,
  "updatedAt": "2026-05-05T14:00:00Z",
  "evidenceHash": "QmX7b2...",
  "dimensions": {
    "access_control": 95,
    "economic_soundness": 92,
    "oracle_integrity": 98,
    "compositional_risk": 91,
    "governance": 92,
    "maturity": 89,
    "adversarial_resilience": 62,
    "supply_chain": 88,
    "liquidity": 0,
    "cross_chain": 0,
    "opsec": 82,
    "cascade_exposure": 100
  },
  "cascade": {
    "blastRadius": 0,
    "upstreamDeps": 1
  },
  "findings": {
    "critical": 10,
    "high": 15,
    "medium": 48
  },
  "metadata": {
    "category": "DEX / AMM",
    "chain": "Multi-chain",
    "tvl": "$3.5B",
    "contracts": 8,
    "zFactor": 0.744
  }
}

Batch Request

Terminal

curl -X POST https://oracle.blackhart.io/api/v1/scores/batch \
  -H "Content-Type: application/json" \
  -d '{
    "slugs": ["aave-v3", "sky", "lido", "uniswap-v4"]
  }'

Rate Limits

Free (no key)1,000 req/day

Developer ($49/mo)50,000 req/day

← Examples Use Cases →