API Reference

● Live scores — updates every 15 min

loading

…

Quick Start

Your first API call

No SDK needed. One HTTP request returns scores for every asset in your vault.

curl

# Single asset deep profile — score, tier, signals, 7d history
curl https://upfront-calm-chatroom.ngrok-free.dev/v1/protocol/asset/USDT \
  -H "X-API-Key: YOUR_KEY"

response

// fetching live example…

Endpoints

Base URL: https://upfront-calm-chatroom.ngrok-free.dev

Public (no auth)

GET /v1/risk-scores

All 190+ asset scores in one call. Latest fragility score, depeg probability, asset class, and full component breakdown per asset. Optional ?asset_class=stablecoin filter.

no auth190+ assets15-min freshness

GET /v1/risk-scores/history?asset=USDT&days=7

Time-series of fragility scores for a single asset. Up to 90 days. Returns score + depeg probability per data point (~4 per hour).

no authup to 90d

GET /report/{asset}

Human-readable shareable risk report for any tracked asset. Shows score, 15-day chart, signal breakdown, and recent alerts. Designed to share with risk committees and counterparties.

HTMLshareableno auth

GET /v1/yields

Supply and borrow APRs from Aave, Compound, and Curve across 16 pools. Pair with /v1/risk-adjusted-yields to rank genuine risk-adjusted returns.

no authDeFiLlama

GET /v1/risk-adjusted-yields

Normalises yields by fragility score: risk_adj = apr / (1 + score/100). A 10% APR on a score-80 asset is not the same as 10% on a score-10 asset.

no auth

GET /v1/alerts?limit=20

Recent fragility alerts: peg deviations, reserve staleness, score spikes. Triggered automatically when any asset crosses a risk threshold.

no auth

B2B / Protocol (requires API key, tier ≥ pro)

GET /v1/protocol/asset/{symbol}

Full single-asset risk profile: score, tier, vault eligibility, recommended action, 24h delta, top signals, full component breakdown, 7-day score history, recent alerts. Built for monitoring systems and dashboards.

API key requiredtier: profull breakdown

POST /v1/protocol/portfolio

Submit your vault holdings and receive a complete risk assessment: per-asset scores, vault eligibility, recommended actions, and a portfolio-level weighted risk summary with IMMEDIATE_REVIEW_REQUIRED / MONITOR / NO_ACTION tiers.

API key requiredtier: proup to 50 assets

POST /v1/webhooks

Register a webhook URL to receive real-time alerts when any asset score changes significantly or crosses a tier boundary. Payloads are HMAC-SHA256 signed. List and delete webhooks via GET/DELETE.

API key requiredHMAC-signedreal-time

Scoring

Fragility Tiers

Every asset is scored 0–100 every 15 minutes. Scores aggregate 10+ independent risk signals.

DANGER

75 – 100

Active risk event. Remove from vault or reduce exposure immediately.

CAUTION

50 – 74

Elevated risk. Monitor closely. Not vault eligible.

WATCH

25 – 49

Mild signals. Conditionally eligible. Review weekly.

SAFE

0 – 24

No significant risk signals. Vault eligible.

Code Example

Portfolio risk in one call

Submit your vault holdings and receive a full risk breakdown.

curl

curl -X POST https://upfront-calm-chatroom.ngrok-free.dev/v1/protocol/portfolio \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assets": ["USDT", "USDC", "DAI", "FRAX"],
    "include_signals": true,
    "include_alerts": true
  }'

response

{
  "portfolio": {
    "asset_count": 4,
    "weighted_score": 72.1,
    "portfolio_tier": "CAUTION",
    "portfolio_action": "IMMEDIATE_REVIEW_REQUIRED",
    "breakdown": { "danger": 2, "caution": 1, "watch": 1, "safe": 0 },
    "highest_risk_asset": { "asset": "FRAX", "score": 100.0, "action": "REMOVE_FROM_VAULT" }
  },
  "assets": [ /* per-asset breakdown */ ]
}

Live Examples

Sample Risk Reports

Shareable per-asset reports — link directly to counterparties or risk committees.

FRAX

Stablecoin · 176bp depeg

—

USDT

Stablecoin · Reserve staleness

—

USDC

Stablecoin · Fully reserved

—

Authentication

API Keys & Tiers

Send your API key in the X-API-Key header or as ?key= query param.

rate limits

Tier       Requests/hour   Endpoints
free       60              /v1/risk-scores, /v1/alerts, /v1/yields
pro        600             + /v1/protocol/*, /v1/webhooks
enterprise unlimited       + priority SLA, custom webhooks, raw signals

Keys are scoped per client and rotate on request. Usage logs available via /v1/admin/usage (owner only).

Get API Access

We're onboarding a small number of protocol risk committees and vault operators. Reach out with your use case and expected request volume.

Request Access View Live Dashboard

Real-time DeFi riskscores. One API call.