BlackHartBlackHart
Oracle/Embed Widget

Embed BRI Scores

Drop a single script tag into any site to display real-time BRI risk scores. Shadow DOM isolation means it works on any page without CSS conflicts. Scores auto-refresh every 5 minutes.

Configure

Anonymous access: 100 req/day. Free key: 1,000/day. Embed keys are rate-limited separately and only return composite scores.

Live Preview

Embed Code

<script src="https://blackhart.io/embed/bri.js"
        data-protocol="aave-v3"
        data-theme="dark"
        data-size="md"></script>

Size Comparison

SM -- Inline Badge
MD -- Card (default)
LG -- Full Card + Radar

Integration Guide

Data Attributes

AttributeRequiredDefaultDescription
data-protocolYes--Protocol slug (e.g. aave-v3)
data-themeNodarkdark or light
data-sizeNomdsm (inline badge), md (card), or lg (full card with radar)
data-keyNoanonymousAPI key for higher rate limits. Embed keys are rate-limited separately and only return composite scores (no paid fields). Get one at /oracle/docs

Forge Scale Ratings

ADAMANTINE
950-1000
MITHRIL
850-949
DAMASCUS
750-849
TEMPERED
650-749
FORGED
550-649
CAST
450-549
RAW
300-449

Technical Details

  • --Shadow DOM -- Styles are fully encapsulated. No CSS leakage in either direction.
  • --No dependencies -- Vanilla JavaScript. No React, no Tailwind, no build step needed.
  • --Auto-refresh -- Scores update every 5 minutes automatically.
  • --CORS enabled -- Embed from any origin. API responses include proper CORS headers.
  • --Cache -- Responses cached for 5 minutes (Cache-Control: public, max-age=300).
  • --Rate limits -- Anonymous: 100/day. Free API key: 1,000/day. Partner: effectively unlimited.

API Endpoint

GET /api/v1/embed?protocol=aave-v3

Response:
{
  "protocol": "Aave V3",
  "slug": "aave-v3",
  "score": 914,
  "rating": "MITHRIL",
  "ratingLabel": "Mithril",
  "grade": "A",
  "color": "#60a5fa",
  "description": "Legendary resilience",
  "category": "Lending / Borrowing",
  "chain": "Multi-chain",
  "tvl": "$15B+",
  "lastUpdated": "2026-05-05",
  "dimensions": [...],
  "poweredBy": "BlackHart BRO"
}

Need a custom integration or higher rate limits?

Full API DocsGet API Key