API Documentation

RWA risk intelligence, regulatory evidence, and macro economic data — 193 endpoints, all ECDSA-signed.

61 RWA Protocols 9 Risk Vectors ECDSA-Signed MiCA & DORA 54 Macro Endpoints
RWA Risk Oracle MiCA Compliance RLUSD Evidence Integrity Suite Macro Oracle Chainlink Swagger OpenAPI 3.1

⚡ Quickstart

Auth: X-API-Key: YOUR_KEY
Base URL: https://feedoracle.io
Docs: Swagger UI · OpenAPI 3.1 · llms.txt
MCP: npx -y mcp-remote https://feedoracle.io/mcp/sse
Top Endpoints:
/v1/rwa/risk — all protocols
/v1/rwa/risk/{slug} — single report
/v1/rwa/registry/{slug} — identifiers
/v1/rwa/legal-state/{slug} — compliance

What FeedOracle Is

FeedOracle is an independent data provider for RWA risk intelligence, compliance data, and sustainability indicators. We aggregate, structure, and deliver machine-readable data designed for disclosure and reporting workflows.

Core Function

  • Aggregates sustainability data for 50+ blockchain networks
  • Structures data for regulatory frameworks (MiCA, CSRD/ESRS)
  • Provides cryptographic attestation via the DAP protocol
  • Documents methodology, sources, and data quality transparently

What FeedOracle Is NOT

Important: FeedOracle operates strictly as a data provider. The following activities are explicitly outside our scope.
Not a compliance advisorWe do not advise on regulatory obligations or interpret regulations for specific entities
Not a certifier or approverWe hold no regulatory authority and issue no certifications or approvals
Not a rating agencyWe do not produce ESG ratings or creditworthiness assessments
Not a legal advisorWe do not provide legal interpretation of MiCA, CSRD, or any regulation
Not an auditorWe do not audit or verify user disclosures to regulators

Responsibility Allocation

  • FeedOracle: Delivers data as documented, maintains stated methodologies, provides signed evidence artifacts
  • Data User: Validates suitability, ensures compliance, bears disclosure responsibility

Who Uses FeedOracle

FeedOracle APIs serve organizations requiring RWA risk scoring, compliance data, and sustainability indicators for compliance, reporting, and operational workflows.

Crypto-Asset Service Providers (CASPs)

Integrate MiCA-aligned sustainability disclosures. Retrieve structured data on energy, emissions, and consensus for supported crypto-assets.

Exchanges & Trading Platforms

Populate sustainability transparency pages. Display per-network metrics with source attribution and update timestamps.

RegTech Platforms

Embed disclosure modules into compliance platforms. API-first design supports white-label and custom integrations.

Asset Managers & ESG Teams

Assess portfolio sustainability for ESG mandates. Third-party sourced data supports due diligence requirements.

Auditors & Compliance Reviewers

Verify historical data snapshots using DAP attestation. Cryptographic proofs confirm data delivery independent of client records.

AI Agents & Autonomous Systems

Consume verifiable sustainability signals. DAP enables programmatic verification without human intervention.

Architecture

FeedOracle operates as a layered data infrastructure. For detailed documentation, see Architecture Overview.

Layer 5: EVIDENCE         ECDSA Signatures, Evidence Packs, Multi-Chain Anchoring
Layer 4: REGISTER EVIDENCE  MiCA Register Lookup, ISO 20022, Circuit Breaker, CCI Score
Layer 3: API GATEWAY      REST endpoints, authentication, rate limiting, OpenAPI 3.1
Layer 2: PROCESSING       Normalization, quality scoring, confidence calculation
Layer 1: DATA SOURCES     Blockchain RPCs, CCRI, DeFiLlama, GeckoTerminal, FRED, ECB, World Bank, Ankr

Authentication

Include your API key in the request header:

X-API-Key: YOUR_API_KEY

Auth Semantics

  • Public (ignore X-API-Key): /api/v2/verify/*, /api/v2/snapshots/*, /api/v2/quality/status, /api/v2/l2/*
  • Tier-gated (require key): /api/v2/webhooks*, /api/v2/exports*
  • Enterprise-only: /api/v2/enterprise/pack

Note: Public endpoints ignore X-API-Key if provided. Do not send keys to public endpoints unless required by internal policy.

Clarification: Verification (reading existing attestations) is public. EPM generation (creating new Evidence Pack Manifests) is tier-limited — see Pricing.

Get your API key at /pricing.

Base URL

https://feedoracle.io

MCP Server 9 TOOLS

FeedOracle provides a Model Context Protocol (MCP) server that gives AI agents direct access to regulatory compliance tools. Any MCP-compatible client — Claude Desktop, Cursor, Windsurf, or custom agents — can connect instantly.

Connect

MethodDetails
SSE Endpointhttps://feedoracle.io/mcp/sse
Auto-Discoveryhttps://feedoracle.io/.well-known/mcp/server.json
Health Checkhttps://feedoracle.io/mcp/health
MCP Registryio.feedoracle/compliance
JWKShttps://feedoracle.io/.well-known/jwks.json

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "feedoracle": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://feedoracle.io/mcp/sse"]
    }
  }
}

Terminal (one-liner)

npx -y mcp-remote https://feedoracle.io/mcp/sse

Available Tools

ToolDescriptionInput
compliance_preflightPre-trade PASS / WARN / BLOCK with reason codes, MiCA + evidence + custody combinedtoken_symbol, action, jurisdiction
mica_statusMiCA EU authorization check (ESMA/EBA cross-referenced)token_symbol
evidence_profileEvidence quality grade A–F: governance, custody, reserves, market depthprotocol
custody_riskCustody & counterparty risk, SIFI status, concentration (DORA Art.28)protocol
market_liquidityDEX liquidity depth & exit channels (MiCA Art.45)protocol
evidence_leaderboard69 protocols ranked by evidence grade A–Ftop_n (default 15)
rlusd_integrityRLUSD real-time attestation: peg deviation, reserve ratio, CCI score
macro_riskUS macro risk from 86 FRED series: recession, rates, inflation
generate_reportSigned PDF report with XRPL anchoring, cryptographic verificationreport_type

Verdicts

VerdictMeaningAgent Action
PASSCompliant, evidence verifiedExecute transaction
WARNPartial evidence or pendingExecute with caution
BLOCKNon-compliant or high severityAbort transaction

Response Schema

Every tool returns a unified envelope with cryptographic signing:

{
  "schema_version": "2.1.0",
  "tool": "compliance_preflight",
  "request_id": "fo-d2e33f04f33f",
  "timestamp": "2026-02-20T11:57:51Z",
  "decision": "PASS",
  "reason_codes": ["ALL_CHECKS_PASSED"],
  "confidence": 1.0,
  "evidence": { ... },
  "sources": [{"registry": "...", "fetched_at": "..."}],
  "meta": {"ttl_seconds": 300, "data_freshness": "live", "jurisdiction_scope": "EU"},
  "signature": {"alg": "HMAC-SHA256", "sig": "...", "kid": "fo-hmac-v1"}
}

MCP Tier Availability

FeatureFreeDeveloper €49Professional €299Enterprise
MCP tools9999 + custom
API calls/day1005,00050,000Unlimited
Rate limit30/min30/min30/minCustom
Claude Desktop
PDF reports
XRPL anchoring

API Availability by Tier

Carbon Monitor API

FeatureFreeDeveloper €49Professional €299Enterprise
Networks50505050+ + custom
Third-party sourcedIncluded 7Included AllIncluded All
Historical data30 daysFull historyUnlimited
Requests100/day5,000/day50,000/dayUnlimited
DAP AttestationBasicFullFull + Export

MiCA Disclosure API (v3)

FeatureFreeDeveloperProfessionalEnterprise
Sustainability reportsSampleIncludedIncludedIncluded
Temporal metadataIncludedIncludedIncluded
DAP attestationBasicFullFull
Disclosure reportIncludedIncluded + custom
Audit exportIncluded

RWA Health Monitor

FeatureFreeDeveloperProfessionalEnterprise
Asset coverage5AllAllAll
Health scoresIncludedIncludedIncludedIncluded
Treasury dataBasicFullFull
Historical90 daysUnlimited

Macro Economic Oracle 54 ENDPOINTS

86 FRED series + 10 ECB series across 12 categories. Full Macro API Docs →

FeatureFreeDeveloperProfessionalEnterprise
Endpoints54545454
FRED Series86868686
ECB Series20202020
Update frequencyDailyHourlyReal-timeReal-time
Verified sourcesIncludedIncludedIncluded

Verified Reports API

Evidence Report Generation 5 ENDPOINTS

Signed PDF evidence. SHA-256 + ECDSA + XRPL. Evidence Terminal

POST/reports/api/report/generateGenerate signed report
GET/reports/api/report/{id}/pdfDownload PDF
GET/reports/api/report/{id}/verifyVerify integrity
GET/reports/api/reportsList all reports
GET/reports/api/healthService health
TypePagesContent
rwa_risk4Portfolio risk, top-15, heatmap
macro_risk3Recession, yield curve, FRED
mica2Stablecoin compliance, EU auth
dora2Service inventory, DORA mapping

Carbon Data

GET /api/v1/feeds/carbon/chains

Retrieve carbon and sustainability data for all 50+ blockchain networks.

{
  "count": 54,
  "timestamp": 1739836800,
  "chains": [{
    "symbol": "ETH",
    "chain": "Ethereum",
    "consensus": "Proof of Stake",
    "energy_twh_year": 0.0026,
    "co2_mt_year": 0.0013,
    "renewable_energy_percent": 52,
    "green_score": 85,
    "data_quality": "THIRD_PARTY_VERIFIED",
    "data_source": "CCRI"
  }]
}
GET /api/v1/feeds/carbon/summary

Aggregated statistics across all tracked networks.

Disclosure API v3 DAP

GET /api/v3/disclosure/networks

List all networks with disclosure support status and attestation.

GET /api/v3/disclosure/sustainability/{symbol}

Full sustainability disclosure report with DAP attestation. Structured for MiCA disclosure workflows.

{
  "feedoracle_disclosure_data": {
    "schema_version": "3.0",
    "temporal": {
      "timestamp": "2026-02-18T09:14:01.319Z",
      "timestamp_unix": 1736765400123
    },
    "network": {
      "name": "Ethereum",
      "symbol": "ETH",
      "consensus": "Proof of Stake"
    },
    "sustainability_indicators": {
      "energy": {"annual_kwh": 2600000, "per_tx_kwh": 0.006476},
      "emissions": {"annual_tco2e": 1300, "intensity_gco2_kwh": 335},
      "renewable": {"percentage": 52}
    },
    "provenance": {
      "level": "third_party_sourced",
      "source": "CCRI"
    }
  },
  "attestation": {
    "attestation_id": "dap_2026_q1_abc12345",
    "data_hash": "7f83b1657ff1fc53b92dc18148a1d65d...",
    "verify_url": "https://feedoracle.io/verify/dap_2026_q1_abc12345"
  },
  "legal": {
    "disclaimer": "Data provided for informational purposes only.",
    "responsibility": "User responsible for regulatory compliance.",
    "terms": "https://feedoracle.io/terms.html"
  }
}

DAP - Disclosure Attestation Protocol NEW

Cryptographic proof of what data was delivered, when it was delivered, and that it has not been altered. Every API response is hashed, aggregated into Merkle trees, and anchored on-chain.

What DAP Proves: DAP provides evidence of data delivery. It does not certify, approve, or guarantee accuracy or regulatory compliance of the underlying data.

Blockchain Anchoring

XRPLrKs1JjEArqPW...cGdMq93w

Report hashes anchored as XRPL memo fields. Verify via xrpscan.com.

GET /api/v2/attestation/status

DAP service status including on-chain connection info.

GET /verify/{attestation_id}

Public verification endpoint. Anyone can verify an attestation without authentication.

GET /api/v2/attestation/chains

Status of all anchoring chains with balances and contract addresses.

MOAT v2 Evidence NEW

Verify, Snapshots, Quality. Full docs →

Webhooks PRO+

Real-time events. Full docs →

POST /api/v2/webhooks

S3 Exports PRO+

Export to your S3. Full docs →

POST /api/v2/exports/s3/run

L2 Intelligence NEW

Fee Oracle + Health. Full docs →

GET /api/v2/l2/cheapest

Enterprise Features ENTERPRISE

GET /api/v2/attestation/audit/export

Export attestations for audit purposes. Supports JSON and CSV formats.

ParameterTypeDescription
startstringStart date (YYYY-MM-DD)
endstringEnd date (YYYY-MM-DD)
formatstringjson (default) or csv

PDF Disclosure Reports (Professional+)

Access: Requires X-API-Key header. Available for Professional (€299/mo) and Enterprise tiers. Get API Key →
GET /api/v2/reports/mica-art66

Generate MiCA Disclosure PDF Report with chain data and attestation.

curl -H "X-API-Key: KEY" "https://api.feedoracle.io/api/v2/reports/mica-art66" -o report.pdf

Download Sample

GET/api/v2/reports/csrd-esrs

CSRD/ESRS E1 Climate Disclosure.

Sample CSRD

GET/api/v2/reports/dora-operational

DORA Operational Resilience.

Sample DORA

GET /api/v2/attestation/compliance/report/{symbol}

Generate disclosure report for a specific network with DAP attestation.

Data Disclaimer

Important: This disclaimer applies to all FeedOracle data and must be understood by all data consumers.

FeedOracle provides data for informational purposes to support regulatory disclosure obligations. This data does not constitute legal, financial, tax, or compliance advice.

Data Quality Levels

  • Third-Party Sourced: Data obtained from established external providers (Cambridge CBECI, CCRI, DNV) who maintain independent data collection methodologies. "Verified" refers to source integrity, not audit or certification. Source attribution provided.
  • Calculated: Data computed by FeedOracle using documented methodologies. Methodology available upon request.

User Responsibility

Data users are solely responsible for:

  1. Validating data suitability for their specific use case
  2. Ensuring compliance with applicable regulations
  3. Accuracy of disclosures to competent authorities
  4. Independent verification where required by their regulatory framework

Standard API Response Footer

{
  "legal": {
    "disclaimer": "Data provided for informational purposes only.",
    "responsibility": "User remains solely responsible for regulatory compliance.",
    "data_quality": "THIRD_PARTY_SOURCED | CALCULATED",
    "source": "Source attribution",
    "timestamp": "ISO 8601 timestamp",
    "terms": "https://feedoracle.io/terms.html"
  }
}

Language Guidelines

FeedOracle maintains strict language standards for legal and regulatory safety.

Forbidden Phrases

MiCA compliantImplies regulatory approval we cannot grant
MiCA certifiedOnly NCAs can certify compliance
Guaranteed complianceNo data provider can guarantee this
Official MiCA reportSuggests regulatory authority status
Approved byImplies endorsement we do not have
AuditedReserved for formal external audits

Allowed Alternatives

Supports MiCA disclosure workflowsDescribes function accurately
Structured for regulatory reportingNeutral, factual
Aligned with CSRD requirementsDescribes data structure
Third-party sourced from [Name]Clear attribution
Calculated using documented methodologyTransparent process

Use Cases

For detailed integration examples, see the Use Cases documentation.

RWA Context Layer

Institutional macroeconomic data for RWA validation

GET /worldbank/gdp Top economies by GDP
GET /worldbank/country/{iso3} All indicators for country (GDP, growth, inflation)
GET /grid/uk/now Real-time UK grid carbon intensity
GET /grid/uk/generation Current UK energy generation mix
GET /grid/country/{iso2} Historical grid carbon by country (EMBER)
GET /energy/country/{iso3} Energy data: renewable share, carbon intensity (OWID)
GET /energy/renewable/{iso3} 5-year renewable energy trend
GET /trade/country/{iso3} Trade flows: imports, exports, balance (UN Comtrade)
GET /api/v1/macro/health Economic Health Index (86 FRED + 10 ECB series)
GET /api/v1/macro/all All macro indicators combined (86 FRED + 10 ECB)
GET/api/v1/macro/ecbECB rates, EUR/USD, HICP, GDP (10 ECB series)
GET/api/v1/macro/yield-curveFull Treasury curve 1M-30Y + spreads
GET/api/v1/macro/equitiesS&P 500, NASDAQ, Dow Jones
GET/api/v1/macro/cryptoBTC/USD, ETH/USD via FRED
GET/api/v1/macro/stressVIX, Financial Stress, HY spreads

All 54 Macro Endpoints →

NFT & Gas Monitor LABS

On-chain attestations with gas optimization

GET /api/nft/gas
GET /api/nft/queue View pending attestation queue
GET /api/nft/worker/status Background worker status + log
POST /api/nft/dap/attest Create attestation (auto-queued if gas high)
GET /api/nft/contracts