RWA Risk Oracle — API Reference

Risk Scoring Core

Multi-vector risk scores for tokenized asset protocols. 9 dimensions weighted into a composite 0–100 score with letter grades (A–F). Includes algorithmic reason codes explaining each score.

Protocol Registry Supporting

Structured identifiers for each protocol: token metadata (symbol, chain, contract address), issuer details (name, country, LEI), and underlying asset classification (ISIN, type). Powers compliance mapping and cross-referencing.

Compliance Intelligence Core

Cross-border regulatory status for each protocol: jurisdiction accessibility, sanctions screening (OFAC/EU/UN), investor qualification requirements, and reporting obligations. Powers MiCA Article 66 and DORA workflows.

Legal State Supporting

Legal structure analysis: contract upgrade powers, ownership authority, transfer finality mechanisms, dispute resolution frameworks, and risk flags for each protocol.

Oracle Feeds Core

Real-time consensus price feeds for tokenized assets. Multi-source aggregation (median/weighted median) with outlier removal, disagreement detection, and staleness monitoring. Sources include Chainlink, Pyth, CoinGecko, and direct exchange feeds. Prices are validated against configurable deviation thresholds before publication.

DEX Liquidity Enrichment

On-chain DEX liquidity depth, volume, and pair diversity across chains and decentralized exchanges. Note: many RWA tokens (e.g. tokenized T-Bills) trade primarily via mint/redeem on the primary market rather than on DEXes. For these assets, the result.liq.cat may show THIN or NO_DEX — this does not necessarily indicate illiquidity but rather a different redemption model (e.g. T+0, T+1, daily NAV).

On-Chain Transparency Enrichment

Smart contract verification status, proxy patterns, transaction activity recency, and on-chain trust signals.

ESG / Carbon Enrichment

Environmental scoring based on chain-weighted carbon footprint. Sources include FeedOracle Carbon Chain API, EU ETS, Ember Climate, and VeChain ToolChain (source pipeline DNV-certified under ISO 14040/14044).

Events Supporting

Risk-relevant events detected for each protocol: anomalies, governance changes, peg deviations, liquidity shifts, and regulatory developments.

Score History Supporting

Historical risk score tracking. Enables trend analysis and score change monitoring over time.

Discovery Enrichment

New protocol detection: monitors DeFiLlama for untracked RWA protocols and provides coverage analysis.

Yield Analysis NEW

Yield decomposition and source classification. Injected into /v1/rwa/risk/{slug} responses as yield_analysis block. Answers: "Where does the yield come from, and how does it compare to risk-free?"

This is best-effort classification based on issuer disclosures and public sources. Not investment advice. Confidence scores indicate data certainty.

Yield Source Classes

Response Fields

{
  "nominal_apy": 0.052,
  "benchmark": {
    "name": "US_TBILL_3M",
    "source": "FRED",
    "rate": 0.045,
    "observed_at": "2026-02-11T00:00:00Z"
  },
  "credit_spread": 0.007,
  "yield_source_class": "US_TREASURY_BILLS_DIRECT",
  "derivation": {
    "method": "nominal_minus_benchmark",
    "inputs": ["defillama_yield", "fred_tbills_3m"]
  },
  "confidence": 0.80,
  "notes": "USDY backed by short-duration US Treasuries and bank deposits."
}

{
  "nominal_apy": 0.0,
  "benchmark": { "name": "US_TBILL_3M", "source": "FRED", "rate": 0.036 },
  "credit_spread": -0.036,
  "yield_source_class": "STABLECOIN_NO_YIELD",
  "confidence": 0.95,
  "notes": "Reserves generate yield for issuer, not holders."
}